+993のトルクメニスタン認証をOTPパイプラインに組み込む方法

トルクメニスタンの認証用番号を返すAPIは何ですか?

まずエンドポイントから始めましょう。ほかのすべてがそこから決まります。Developerコンソールで発行したBearerキーを使って https://otproute.com/api/v1 に認証します。キーの接頭辞は or_live_ で、1アカウントに最大10個まで持てます。トルクメニスタンの国idは tm です。

1. GET /api/v1/services と GET /api/v1/countries でカタログを取得します。キャッシュしてかまいませんが、毎日更新してください。
2. GET /api/v1/prices?country=tm&service=<id> で、現在の料金と、そのサービスのルートが開いているかが分かります。
3. POST /api/v1/activations に {"service": "imo", "country": "tm"} を送ると、+993の番号が確保され、アクティベーションidが返ります。
4. GET /api/v1/activations/{id} は、+993の注文の状態を返し、SMSが届いた後はコードも返します。
5. POST /api/v1/activations/{id}/cancel で、テストでもう不要になった注文を解放します。
6. GET /api/v1/balance を使えば、残高が少なくなったときにパイプラインを早めに止められます。

アカウントの上限は1分あたり300リクエストで、すべてのキーで共有されます。リクエストとレスポンスの形式はAPIリファレンスに記載されています。

+993のテストはWebhookで待つべきですか、ポーリングすべきですか?

開発者が一人で操作しながら確認するだけなら、ポーリングで十分です。複数のジョブが同時に動くようになったら、Webhookのほうがコストが低く、反応も速くなります。アカウントには5つのWebhookエンドポイントを持てます。そのうちの1つをトルクメニスタンのテストランナーに向け、activation.sms_received、activation.expired、activation.cancelled を受け取ります。

届いたすべての配信は、確認できるまで信頼しないでください。X-OTPRoute-Signature ヘッダーを t と v1 に分け、t、ピリオド、そのままの生のボディをつなげたものに、エンドポイントのシークレットでHMAC-SHA256を計算して、定数時間で比較します。リプレイを防ぐため、短い許容範囲を外れたタイムスタンプは拒否します。結果はアクティベーションidをキーに保存し、再送された配信で何も変わらないようにします。キューを使ったハンドラーの例はWebhookによるOTP取得の記事に、ビルドジョブでのタイムアウトはCIパイプラインでのテストにまとめています。

トルクメニスタンの認証用番号では、何を認証できますか?

tm ルートでは、1,600を超えるサービスが一覧に載っています。現時点でよくリクエストされるものには、imo、Telegram、WhatsApp、Google (Gmail & YouTube)、Instagram、Microsoft & Outlook、LinkedIn、ChatGPT (OpenAI)、Viber、WeChat、Discord、Snapchatがあります。中央アジアでは日常の通信の多くをメッセージングアプリが担っているため、リストでも上位に並びます。

これはあくまでスナップショットであり、保証ではありません。キャリアパートナーからの提供枠は一日の中で変わるので、前日のリストが今も有効だと想定せず、実行のたびに料金を問い合わせてください。

+993の番号はどのような形式で、どうローカライズしますか?

トルクメニスタンの国内番号は8桁で、携帯のレンジの多くは 6 で始まります。国内では前に 8 のトランク接頭辞を付けてダイヤルしますが、国際形式ではこの接頭辞が省かれ、+993 に8桁を続けた形になります。

• システムの入口でE.164形式(+9936XXXXXXX)に正規化し、保存はその形式だけにします。
• 近隣諸国向けに書いた検証ロジックを流用しないでください。中央アジアでは桁数や接頭辞が国ごとに異なります。
• トルクメン語が公用語で、ä、ç、ň、ö、ş、ü、ý、žなどの文字を使うラテン文字で書かれます。ロシア語も広く通じます。そのため認証SMSはトルクメン語、ロシア語、英語のいずれでも届く可能性があり、コード抽出処理ではあらゆるUTF-8の本文から数字を読み取れるようにしておきましょう。

このルートでテストするのは、通常、中央アジアでの展開を計画しているとき、トルクメン語やロシア語のインターフェースのローカライズQAが必要なとき、アシガバートと近隣市場を行き来する顧客に対応するときです。

コードを書かずに+993のコードを注文できますか?

はい。メールのコードまたはGoogleでサインアップし、ウォレットにチャージしたら、OTP Gatewayを開いてサービスを選び、トルクメニスタンを選択して、表示された料金を確認します。+993の番号はすぐに表示されます。アプリが求める場所に入力してSMSをリクエストし、アクティベーションのカードでコードを確認してください。この番号は、その1回の認証にのみ使えます。

トルクメニスタンのコードが届かないのはなぜですか?

• サービスが仮想番号を拒否している。 拒否するサービスもあります。これは先方のポリシーによるもので、返金ルールはまさにこのような場合のためにあります。
• ルートが混み合っている。 時間をおくか、新しいアクティベーションで再試行してください。別の番号が割り当てられます。
• ウィンドウを途中で打ち切った。 アクティベーションは20分間そのままにしておいてください。期限切れの注文は自動的に返金されます。
• 再試行のループが攻めすぎている。 試行の間隔をあけ、連続して注文しないでください。

これらの手順は、同じプールを共有するすべての利用者にとってOTPルーティングを健全に保つことにつながります。

トルクメニスタンの長期回線はありますか?また、請求の仕組みは?

トルクメニスタン向けのセルフサービスの専用番号はありません。OTP Routeが長期回線を提供するのはアメリカとカナダのみで、月額$1.95からです。ほかの国についてのご要望は [email protected] に送っていただけますが、現地の規則で可能になるとは限りません。

それ以外はすべて、月額料金のない1つのプリペイドUSDウォレットで運用します。支払いはカードまたはUSDT/USDCで、チャージごとにPDFの請求書が届きます。開発用アカウントでサンドボックスモードを依頼すれば、模擬の番号でSMS認証APIをテストできます。ご自身の正当なプロダクトとアカウントにのみ、各サービスの規約と当社の利用規定(Acceptable Use Policy)の範囲内でご利用ください。

よくある質問

アプリの登録テスト用に+993番号を取得できますか?

はい。国id tm と選んだサービスでアクティベーションを作成し、返された番号を自社のサインアップフローで使います。

OTP Routeでトルクメニスタンの認証コードはいくらですか?

$0.20/コードからです。サービスごとのライブ料金は料金エンドポイントから取得でき、ダッシュボードにも表示されます。

トルクメニスタンの番号を入力するとき、先頭の8は必要ですか?

いいえ。8は国内ダイヤル専用のものなので、+993と8桁の国内番号を使ってください。

+993のコードに関するWebhookが本当にOTP Routeから来たと、どう確認できますか?

X-OTPRoute-Signatureヘッダー内のHMAC-SHA256署名を生のボディに対して検証し、古いタイムスタンプは拒否してください。

トルクメニスタンの番号にSMSが届かなかった場合、返金は自動ですか?

はい。20分のウィンドウが切れるか、キャンセルすると、全額がウォレットに戻ります。

トルクメニスタンの番号を、繰り返しのログイン用に保持できますか?

セルフサービスではできません。長期番号はアメリカとカナダのみです。特別な要件がある場合はサポートにメールしてください。

トルクメン語圏のOTPメッセージは、何語で届きますか?

アプリによります。トルクメン語、ロシア語、英語のいずれもあり得るため、単語ではなく数字を解析してください。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。