x2rn Docs

このサービスについて

x2rn は、短縮URLとして「読む」ことよりも「通す」ことに特化したサービスです。

ドメイン名 x2rn には、「変数 x を routing / mapping し、定義された先 n に収束させる」という
数学的・構造的な意味合いが込められています。

本サービスは完全サーバレス構成で稼働しており、アカウント登録や恒久的なユーザー管理は行いません。

https://x2rn.net/ にアクセスすると、ブラウザ上で短縮URLの登録・削除が可能です。

「Register」の入力欄に短縮したい URL を入力します。
インスタントURLにしたい場合は、入力欄の右にある Once をオンにし、表示される確認（Cloudflare Turnstile）が完了するのを待ちます。
「Shorten」を押すと、Output に短縮URLが表示されます。

削除する場合は、「Delete」の入力欄に短縮URLの ID（Ab3kQ や xY7kP2mQ9a の部分）を入力して「Delete」を押します。登録したときと同じブラウザから操作してください。

インスタントURLは、1回だけ開ける短縮URLです。一度だけ渡したいリンクの共有に向いています。

リンクプレビューについて：

Discord・LINE・Slack などにリンクを貼ると、プレビュー作成のために自動でアクセスされますが、確認画面を表示するだけなのでリンクは消費されません。消費されるのは「開く」を押したときだけです。

curl -X POST "https://regist.x2rn.net?url=https://example.com"

正常に登録されると、ステータス 201 で短縮URLがレスポンスとして返却されます。

登録する URL に & や ? などが含まれる場合は、パーセントエンコードして渡してください（例：url=https%3A%2F%2Fexample.com%2F%3Fa%3D1%26b%3D2）。

インスタントURLは人間確認（Cloudflare Turnstile）が必要なため、curl からは発行できません。Web UI を利用してください。

削除には、登録時に発行された x2rn_sid（セッションID）が必要です。インスタントURLも同じ方法で削除できます。

curl -X POST \
  -b "x2rn_sid=あなたのセッションID" \
  "https://delete.x2rn.net?id=短縮URLのID"

注意：

ブラウザの Cookie（x2rn_sid）を削除すると、そのセッションで作成した短縮URLは削除できなくなります。
x2rn は「セッション所有」を、唯一の削除権限として採用しています。

短縮URLの登録は、同じ IP アドレスから 1分あたり5回まで です（通常とインスタントの合計）。超えると 429 が返ります。1分ほど待ってから再試行してください。
登録できる URL は http:// と https:// のみ、長さは2048文字までです。
x2rn.net とそのサブドメインへの短縮はできません。
悪用が確認されたドメインへの短縮はお断りしています。
Tor ネットワークからは、短縮URLの登録・削除・転送を含め、本サービスはご利用いただけません（ステータス 403）。

フィッシングやマルウェアへの誘導を防ぐため、登録時と、リンクを開くときに転送先を自動でチェックしています。

登録後に転送先が危険と判定された場合は、リンクを開いても転送せず、「403 — This link has been blocked」と表示します。インスタントURLの場合、ブロックされたリンクは使用済みになりません。

判定はドメイン単位のため、すべての危険なサイトを防げるわけではありません。リンクを開く前に、転送先をご自身でも確認してください。

ステータス	意味
`201`	登録成功。本文に短縮URLが入っています。
`200`	削除成功（`Deleted.`）。インスタントURLの確認画面も 200 です。
`302` / `303`	転送先への移動（通常の短縮URLは 302、インスタントURLの「開く」は 303）。
`400`	パラメータの不足や不正（`url` がない、http/https 以外、長すぎる、`x2rn.net` 宛て、存在しないドメイン、ユーザー名を含む URL など）。
`403`	転送先が危険と判定された・お断りしているドメイン・ほかの短縮URL・IP アドレス直接指定、人間確認の失敗、または削除時のセッションIDが一致しない。リンクを開いたときに転送先が危険と判定された場合や、Tor からのアクセスも 403 です。
`404`	短縮URLが存在しない、または期限切れ・削除済み。
`405`	メソッドが違う（登録・削除は POST のみ）。
`410`	インスタントURLが使用済み・期限切れ・削除済み。
`429`	登録回数の上限（1分あたり5回）を超えた。
`503`	転送先の安全チェックが一時的にできない、またはインスタントURLの発行を一時的に停止している。時間をおいて再試行してください。

マルウェア、フィッシング、詐欺、違法行為を助長するコンテンツへの誘導は禁止です。

意図的な大量リクエストや、サービス妨害行為は禁止します。

本サービスはオープンソースではありません。
内部実装の解析や、悪用目的の調査行為は禁止です。