日本語
X（Twitter）の SMS コードを受け取る: プロダクトと QA チーム向けチェックリスト
チームは、OTP Route の OTP Gateway で X 用のワンタイム番号を注文し、X に入力して、ダッシュボード、API のポーリング、または署名付き Webhook でコードを確認することで、X（Twitter）の認証コードを受信できます。料金は 1 コード $0.20 からで、20 分の有効時間中に X から何も届かなければ、ウォレットに全額が返金されます。
X は何のために電話番号を求めるのか？
X は、よく知られたいくつかの場面で電話番号を使います。登録時のメールの代替、既存アカウントへの番号の追加、普段と違う動きで発動するログインチャレンジ、パスワードのリセット、SMS による二要素認証です。X は長年のうちに SMS の二要素認証を使えるアカウントを絞り込み、認証アプリを選択肢として提供しているため、テスト対象のアカウントの現在の設定を確認してください。これらのフローはどれも短い数字のコードを送り、プロダクトが X アカウントと連携したり管理したりするなら、どれもカバーする価値があります。典型的なケースは、ブランドアカウントをオンボーディングするソーシャルメディアツール、共有のチームログインでクライアントのプロフィールを運用するエージェンシー、ユーザーが X プロフィールを連携した後の自社アプリの挙動を確認する QA スイートです。
X（Twitter）の SMS 認証テストのプリフライトチェックリスト
- 所有権。 アカウントがご自身、会社、または運用を依頼したクライアントのものである。実在する一人または一つの事業につき 1 アカウント。
- 規約。 電話番号と自動化に関する X のルールを読んでください。当社の利用規定（Acceptable Use Policy）に加えて適用されます。
- 国。 注文前に、アカウントがどの市場を表すかを決めます。
- サービス ID。 OTP Route での X のサービス ID は
twitterです。 - 配管。 Bearer キー（
or_live_）と、ポーリングループか Webhook エンドポイントのどちらか。 - 寿命。 このアカウントは 1 か月後にまたログインする必要があるか？ ある場合は、始める前に専用回線のセクションをお読みください。
198 か国のうち、どの国の番号を使うべきか？
X のルートは 198 か国をカバーしており、米国、カナダ、英国、ドイツ、フランス、インド、インドネシア、フィリピン、日本、ブラジル、メキシコ、トルコ、サウジアラビア、ケニア、ナイジェリア、ガーナなどが含まれます。アカウントが対象とする市場、または検証するテストケースに番号を合わせてください。地域向けのブランドアカウントにはその地域の番号を持たせ、ローカライズのテストにはその国の言語と番号形式が必要です。また、番号、IP の位置情報、プロフィールの食い違いは、X 側で追加の確認を促しうるシグナルでもあります。
手順: API で X 用の番号を注文する
ベース URL: https://otproute.com/api/v1。
GET /api/v1/prices?country=<id>&service=twitterで組み合わせの料金を調べます。現在の提供状況も確認できます。- 注文を作成します。
POST /api/v1/activationsに{"service": "twitter", "country": "<id>"}を送り、アクティベーション ID を保存します。 - 返された番号を X の電話番号欄に入力します。
- Webhook イベントからコードを受け取るか、
GET /api/v1/activations/{id}を、コードが表示されるまでポーリングします。 - X が番号を拒否した場合は、
POST /api/v1/activations/{id}/cancelで解放します。
国 ID は GET /api/v1/countries から取得します。リクエストとレスポンスの形式は API ドキュメントにあります。
Webhook レシーバーはどう構築すべきか？
activation.sms_received、activation.expired、activation.cancelled を購読します。すべての配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで、タイムスタンプ、ドット、生の本文に対する HMAC-SHA256 を計算し、定数時間で比較して、古いタイムスタンプは拒否します。配信は繰り返されることがあるため、処理済みのアクティベーション ID を保存し、重複を無視してください。小規模なスイートなら、1 分あたり 300 リクエストの範囲に十分収まるポーリングも有効な代替手段です。HMAC のガイドに実例があります。
クリック操作がお好みなら、ダッシュボードで OTP Gateway を開き、X と国を選び、表示された料金を確認して、番号を X に貼り付け、注文の横にコードが表示されるのを待ちます。
トラブルシューティング: X がコードを送ってこない
- 番号が拒否された。 X は仮想番号を断ることがあり、その番号は使えないというメッセージが出る場合もあります。キャンセルして、時間をおくか別の国で再試行してください。
- まだ何も届いていない。 すぐに再注文せず、20 分の有効時間を開いたままにしてください。
- X が制限をかけている。 一つのアカウントからの繰り返しのリクエストは、X 側の制限を発動させることがあります。試行の間隔を空けてください。
- 自分のハンドラーが取りこぼした。 ログで署名の検証失敗やエラーを確認してください。
- アカウントにフラグが立っている。 X がアカウント自体を制限している場合、新しい番号では状況は変わりません。X のサポート窓口で解決してください。
返金ルールにより、失敗のコストはなくなります。コードが届いたときにのみ課金され、期限切れやキャンセルになったアクティベーションは全額がウォレットに戻ります。
米国またはカナダの専用回線が向いているのはいつか？
1 回限りのアクティベーションは単発の認証に向いています。数か月先にログインチャレンジを通過したり、アクセスを復旧したりする必要がある会社のアカウントには、変わらず残る番号が必要です。専用番号（Dedicated Numbers）は米国とカナダで $1.95/月 からそれを提供し、受信 SMS はダッシュボードと number.sms_received 経由の Webhook に届き、送信 SMS とブラウザーからの通話も使えます。両方の比較は仮想番号をご覧ください。OTP Route はすべてを 1 つのプリペイドウォレットから請求し、カードまたは USDT/USDC でチャージでき、PDF の請求書が発行されます。
よくある質問
OTP Route の API で X（Twitter）のサービス ID は何ですか？
twitter です。料金のリクエストとアクティベーションの本文で使います。
SIM カードなしで X の OTP を受信できますか？
はい。198 か国のいずれかの OTP Gateway 番号で受信でき、ダッシュボードに表示されるか、Webhook に送信されます。
X に「この電話番号は使用できません」と表示されたのはなぜですか？
X は一部の仮想番号を拒否することがあります。アクティベーションをキャンセルして返金を受け、別の国で、または時間をおいて試してください。
X の認証コードの料金はいくらですか？
1 コード $0.20 からです。正確な価格は国によって異なり、注文前に表示されます。
後から X へのログインに同じ番号を再利用できますか？
1 回限りのアクティベーションが受信できるコードは 1 つです。繰り返しログインするなら、米国またはカナダの専用番号を使ってください。
OTP Route で X アカウントを大量に作成できますか？
できません。X の規約に基づき、ご自身の正当なアカウントとプロダクトのテストと運用のためのものです。
連携を構築するためのサンドボックスはありますか？
はい。リクエストにより、開発アカウントをサンドボックスに切り替えられ、模擬の番号とコードが返ります。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。