日本語
テストとホスト運用のためのAirbnb電話認証コードの受信
チームは、必要な国向けにairbnbサービスのOTP Route番号を注文し、ダッシュボードまたはAPIと署名付きWebhookでSMSを読み取ることで、Airbnbの認証コードを受信できます。OTP Gatewayの料金は1コード$0.20 からで、20分以内に何も届かなければ全額が返金されます。
Airbnbはいつ電話コードを求めますか？
Airbnbはアカウントごとに電話番号を紐づけ、SMSで送られる短いコードで確認します。この確認は、登録時に番号を追加・変更したとき、見慣れない端末からログインしたとき、2段階認証を有効にしたとき、アカウントを回復するときに表示されるのが一般的です。ホストも、ゲストや予約との連絡のために、確認済みの番号を利用します。
電話番号の確認は、あくまで1つの層にすぎません。Airbnbは別途、本人確認、支払い情報、その他のチェックを求めることがありますが、それらは電話番号では対応できません。OTP Routeが担うのはSMSのステップだけです。
ビジネスチームのうち、誰がAirbnbのOTPを受信する必要がありますか？
現実的な利用者は、自社の正当なアカウントを運用するチームや、このプラットフォームに関連するプロダクトを開発するチームです。
- 物件管理・共同ホスティングの運営会社：会社のホストアカウントを運用しており、担当者の私用の電話を紐づけたくない場合。
- 代理店：代理店・リセラー向けのページで説明しているように、オーナーから許可を受けて掲載物件を管理する場合。
- QAエンジニア：自社の旅行・物件管理ソフトウェアのオンボーディングをテストし、連携を動かす前にテスト用ホストアカウントの確認を済ませる必要がある場合。
アカウントが1か月後にまたコードを必要とするなら、始める前に、後述の専用番号のセクションをお読みください。
Airbnbの番号はどの国のものを使うべきですか？
airbnbサービスは、OTP Gatewayで198か国で利用できます。イギリス、フランス、スペイン、イタリア、ポルトガル、ギリシャ、メキシコ、ブラジル、タイ、インドネシア、日本、オーストラリア、南アフリカ、イスラエル、バミューダ、アメリカなどが含まれます。
ホスト事業が実際に営業している場所、またはテストケースが対象とする市場に合うルートを選んでください。ポルトガルで登録されたホスト事業にはポルトガルの番号を、メキシコ向けのオンボーディングフローのテストには+52の番号が必要です。番号の国とアカウントのプロフィールが一致しないと、追加のチェックが発生することがあり、テスト結果の解釈も難しくなります。
Airbnb認証コードAPIのフローはどのように動きますか？
ベースURLhttps://otproute.com/api/v1と、Developerコンソールで発行したor_live_プレフィックスのBearerキーを使います。サービスIDはairbnbで、国IDはGET /api/v1/countriesから取得します。
GET /api/v1/prices?country=<id>&service=airbnbを呼び出し、最新の料金とルートに空きがあるかを確認します。POST /api/v1/activationsに{"service": "airbnb", "country": "gb"}のようなボディを渡して注文します。- 返された番号をAirbnbの電話番号入力画面に入力します。
activation.sms_receivedのWebhookを処理します。公開エンドポイントがない場合は、GET /api/v1/activations/{id}をポーリングします。上限は1分あたり300リクエストです。
Webhookでは、X-OTPRoute-Signatureヘッダー（t=<unix>,v1=<hex>）を読み取り、エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を計算して、一致しないものや古いタイムスタンプは拒否してください。配信が再試行されることがあるため、アクティベーションIDでハンドラーを冪等にします。パターン全体は、Webhookによるコード取得のガイドとAPIドキュメントで解説しています。
代わりにダッシュボードからAirbnbのコードを受信できますか？
はい。運用チームにはこちらを好む方も多くいます。OTP Gatewayを開き、サービスにAirbnbを選び、国を選んで、表示された料金を確認して確定します。番号はすぐに表示されます。それをAirbnbに入力し、同じダッシュボードの行を見ていてください。SMSが届くと、そこにコードが表示されます。
AirbnbのSMSが届かないのはなぜですか？
Airbnbは多くのプラットフォームと同様に、一部の仮想番号を拒否したり、特定の番号帯へのコード送信を見送ったりすることがあります。ルートによって所要時間も異なります。20分の受付時間と返金ルールがここで守ってくれます。コードが届いた場合にのみ支払いが発生し、期限切れまたはキャンセルされたアクティベーションは全額がウォレットに戻ります。
- 失敗と判断する前に、受付時間が終わるまで待つ。
- 時間をおいて再試行するか、ルート自体が正常かを確認するために、自社アプリの別サービスでその国のルートを試す。
- 注文を立て続けに繰り返さない。ほとんど効果がありません。
- 番号の国がアカウントの市場と一致しているか確認する。
Airbnbアカウントには、どんなときDedicated Numberが適していますか？
ワンタイム番号は1回の確認には理想的ですが、ホストアカウントは何年も使われ、新しいノートパソコンからの次回ログインでコードを求められることがあります。その場合は、保持できるDedicated Numberが適しています。提供地域はアメリカとカナダのみで、月額$1.95 から、ダッシュボードからすぐに購入できます。受信SMSはダッシュボードに表示され、number.sms_receivedとしてWebhookに転送されるため、共有の運用受信箱でAirbnbのコードをすべて確認できます。詳細は仮想番号をご覧ください。
Airbnbの番号の責任ある利用とは何ですか？
Airbnbの規約に従ってください。アカウントは実在の個人または事業者につき1つとし、OTP Routeは自社プロダクトのテスト、または管理する権利のある正当なアカウントの運用にのみ使用してください。OTP RouteはAirbnbと提携しておらず、その名称は権利者の商標であり、すべての注文にAcceptable Use Policyが適用されます。課金は、カードまたはUSDT/USDCでチャージする前払いUSDウォレットで、チャージごとにPDFの請求書が発行され、月額料金はありません。
よくある質問
OTP Route APIでのAirbnbのサービスIDは何ですか？
airbnbです。アクティベーションのボディとGET /api/v1/pricesで使います。
SIMカードを買わずにAirbnbの電話番号を取得できますか？
はい。OTP GatewayはAirbnbのコード1回分の番号を発行し、繰り返しコードが必要なアカウントにはアメリカまたはカナダのDedicated Numberが対応します。
Airbnbはすべての仮想番号を認証に受け付けますか？
いいえ。Airbnbが一部の番号を拒否することがあります。そのため、20分以内にコードが届かなければ自動的に返金されます。
テスト用のAirbnb SMS認証はいくらですか？
国によって異なりますが、1コード$0.20 からです。正確な料金は注文前にAPIとダッシュボードに表示されます。
物件管理者は、後で同じ番号を使って再ログインできますか？
アメリカまたはカナダのDedicated Numberを使う場合のみ可能です。OTP Gatewayのワンタイム番号は、アクティベーションが終了すると保持されません。
ウォレットの資金を使わずにAirbnbのオンボーディングテストを実行できますか？
はい。開発アカウントにサンドボックスモードを申請してください。エンドツーエンドのテスト用に、シミュレートされた番号とコードが返されます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。