APIまたはダッシュボードでコソボのSMS OTPコードを受信する方法

プロダクトチームが+383番号を必要とするのはなぜ?

コソボは小さな市場ですが、海外での存在感は大きく、ドイツやスイス、その他の西ヨーロッパには大規模なディアスポラが暮らしており、その多くが家族や銀行のためにコソボの番号を保持しています。旅行から送金まで、その層に向けたアプリは、+383のユーザーがサインアップ時に体験する内容を確認する必要があります。

もう一つの理由はローカライズです。アルバニア語とセルビア語はどちらも公用語なので、いずれかの言語に翻訳したフローは、スクリーンショットのレビューではなく、実際のエンドツーエンドのテストに値します。OTP Gatewayのコソボの認証番号があれば、QAはどのオフィスからでもそのチェックを実行できます。

プリシュティナを拠点とする、または西バルカン全域を担当する地域の運用チームにも、第三の理由があります。現地の連絡先で登録したビジネスプロフィールが、新しいコードを求めることがあり、それを従業員の端末を回すのではなく、共有で監査可能なツールで処理するほうが優れています。

コソボのルートで今利用できるアプリは?

今日のスナップショットでは、コソボには400を超えるサービスがあります。現在提供されている人気のものには、WhatsApp、Viber、Telegram、Facebook、Instagram、TikTok、Google (Gmail & YouTube)、Microsoft & Outlook、Amazon、Snapchat、Netflix、Airbnb、Uber、Flipkartがあります。

一覧は、ヨーロッパの大きな市場より短く、変動も頻繁です。書かれた一覧はヒントとして扱ってください。信頼できる答えは、注文する時点で GET /api/v1/countries とダッシュボードが返す内容です。

コソボOTP APIの実際の使い方

国IDは xk です。典型的な連携では、GET /api/v1/services からサービスIDを解決し、GET /api/v1/prices?country=xk&service=<id> で費用を確認し、{"service": "telegram", "country": "xk"} のような本文で POST /api/v1/activations を送ってアクティベーションを開きます。レスポンスには、番号と、後で使うアクティベーションIDが含まれます。

その後、コードは activation.sms_received のWebhookとして届き、X-OTPRoute-Signature ヘッダーに "<t>.<raw body>" のHMAC-SHA256で署名されています。古いタイムスタンプは拒否し、再試行された配信が一度だけ処理されるよう、ハンドラーはアクティベーションIDをキーにしてください。CIジョブに公開URLがない場合は、GET /api/v1/activations/{id} のポーリングも使えます。完全な例は連携ガイドをご覧ください。

コソボが+383を得て何が変わり、番号はどう保存すべき?

コソボが独自の国番号+383を得たのは、2010年代後半になってからです。それ以前、同国の携帯ネットワークはモナコやスロベニアのものを含む借用の国番号を使っており、古い顧客記録には今もそうした形式の番号が残っていることがあります。過去のデータをインポートする場合は、自動で書き換えるのではなく、それらのエントリにフラグを付けてください。

国内番号はトランクプレフィックス 0 で始まります。現地で044 123 456と表示される携帯番号は、E.164では+383 44 123 456です。国際形式を保存し、入力時にゼロを取り除き、書式は表示のときだけ整えます。アルバニア語のテキストには、基本のGSMアルファベットにない「ë」などの文字が使われるため、ローカライズしたメッセージはUCS-2で送られ、セグメントが短くなることがあります。

コソボのコードが遅い、または届かないときはどうなる?

アクティベーションに、フルの20分を与えてください。SMSが届かないままウィンドウが閉じた場合、またはキャンセルした場合は、課金が自動的にウォレットへ戻り、activation.expired または activation.cancelled が発火します。次の対応が妥当です。

• 少し間をおいて再試行するか、テストが許すならアルバニアなど隣接するルートを選ぶ。
• 対象のサービスが、そもそも仮想番号を受け付けているか確認する。
• 自動の再試行は、ループで注文するのではなく、バックオフを入れる。

コソボ案件向けの長期回線、ウォレット、サンドボックス

OTP Routeには、コソボのセルフサービスの長期番号はありません。月額$1.95からのDedicated Numbersは、米国とカナダの2か国のみが対象です。+383の継続的な回線が必要な場合は、[email protected] にメールしてください。手配できるかどうかは現地の規制次第です。

支出は、単一の前払いUSDウォレットから、従量課金で引き落とされ、カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。開発者は、開発アカウントのサンドボックスモードをリクエストして、Webhookを組み込む間、模擬の番号とコードを受け取れます。詳細は料金をご覧ください。

よくある質問

本物のコソボの番号で、アプリのアルバニア語のサインアップを確認できる?

はい。OTP Gatewayでテスト用に+383番号を注文し、アルバニア語でサインアップを開始すると、コードがダッシュボードとWebhookに表示されます。

SMS認証APIで、コソボはどのIDを使う?

コソボは、GET /api/v1/prices や POST /api/v1/activations を含む、国を受け取るすべてのエンドポイントで xk です。

コソボの認証番号の費用は?

$0.20/コードからです。正確なレートはサービスによって異なり、注文前に表示されるか、価格エンドポイントから返されます。

コソボのサービスがドイツより少ないのはなぜ?

対応範囲は、キャリアパートナーが各国へルーティングできる範囲に従い、小さな市場ほど一覧が短くなります。テストの実行を計画する前に、最新の一覧を確認してください。

コソボのOTPが届かなかった場合、お金はどうなる?

SMSが届かないまま20分のウィンドウが終わると全額がウォレットに戻り、キャンセルすればすぐに戻ります。

昔の+377や+386の番号は、今もコソボのユーザーのもの?

古い記録に含まれている場合もありますが、新しい番号は+383を使います。古い形式は、盲目的に変換するのではなく、見直すべきデータとして扱ってください。

繰り返しのログインのために+383番号を保持できる?

セルフサービスではできません。ゲートウェイの番号は1回のコード専用で、長期回線は米国・カナダの商品です。コソボについては [email protected] にメールでお問い合わせください。

OTP Routeの番号の使い方にルールはある?

はい。OTP Routeはご自身の正当なプロダクトとビジネスアカウントにのみ使用し、各サービスの規約と利用規定(Acceptable Use Policy)を守ってください。開始するには新規登録をご覧ください。

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