パプアニューギニアの+675認証コードを自動化する

リクエストから始める:APIでPNGの番号を注文する

パプアニューギニアの国IDは pg です。開発者コンソールで作成したBearerキー(プレフィックス or_live_)があれば、最小限の連携は https://otproute.com/api/v1 に対する数回のリクエストだけで済みます。

• GET /api/v1/prices?country=pg&service=<id> で、その組み合わせの現在の価格が返ります。
• POST /api/v1/activations に {"service": "telegram", "country": "pg"} を渡すと、1つのコードのために+675の番号が確保されます。
• GET /api/v1/activations/{id} はステータスを返し、受信後はコードも返します。
• POST /api/v1/activations/{id}/cancel は、使わないアクティベーションを閉じて返金します。
• GET /api/v1/balance を使えば、パイプラインがバッチの前に残高を確認できます。

アカウントでは、キーは最大10個、Webhookエンドポイントは最大5つ、リクエストは毎分300件まで利用できます。リファレンスとクライアントのサンプルは開発者向けページからたどれます。

署名付きWebhookで+675のコードを受信する

数件のテストならポーリングで十分ですが、規模が大きくなるほどWebhookのほうが向いています。エンドポイントを登録すると、OTP Routeは、コードが届いたときに activation.sms_received、ウィンドウが空のまま閉じたときに activation.expired、誰かが番号を解放したときに activation.cancelled をPOSTします。

各リクエストには、t=<unix>,v1=<hex> の形式で X-OTPRoute-Signature が付きます。エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を再計算し、定数時間で比較し、タイムスタンプが古いリクエストは拒否してください。イベントはアクティベーションIDで紐づくため、そのIDを処理済みフラグとともに保存し、重複は無視します。キューイングとリトライについては、WebhookベースのOTP取得の短い解説で触れています。

パプアニューギニアの番号で認証できるものは何ですか?

パプアニューギニアのライブ一覧には800を超えるサービスがあります。この国で、またはこの国向けに業務を行うチームは、メッセージングではよくFacebook、WhatsApp、Telegram、Signalを、業務用アカウントではGoogle(Gmail & YouTube)、Microsoft & Outlook、LinkedInをテストしています。ChatGPT(OpenAI)やClaudeといったAIツールのほか、Instagram、TikTok、Discord、Amazonも並んでいます。

小さな市場では、一日の中でカバレッジの変化がより目立つことがあります。ジョブの最初に GET /api/v1/services を読み込み、pg にそのサービスが現在掲載されていない場合は処理を穏やかにスキップするか、オーストラリアのような近隣の太平洋ルートにテストの向き先を切り替えてください。

PNGの電話番号はどのような構造ですか?

パプアニューギニアはトランクプレフィックスを使わないため、E.164形式は+675に国内番号をそのまま続けたものです。携帯番号は8桁で一般に7から始まり、固定回線はそれより短い7桁です。古い記録には、国が桁数を8桁に変更する前の7桁の携帯番号が残っていることがあるため、そうしたものは黙って受け付けず、データクリーニングの際にフラグを立ててください。

番号はE.164で保存し、種別ごとに桁数を検証し、先頭にゼロを付け足すことは絶対にしないでください。公用語は英語、トク・ピジン、ヒリ・モツで、+675番号宛の認証メッセージのほとんどは英語で届きます。それでもパーサーは、固定フレーズに一致させるのではなく、数字を抽出してください。

ここでテストする理由には、現場スタッフをオンボーディングする資源・物流分野のオペレーション、モバイルツールを運用するNGOや開発プログラム、PNGの顧客へ製品を広げるオーストラリアや太平洋地域の企業、そしてトク・ピジンのUI文言のローカライズチェックなどがあります。

代わりにダッシュボードから注文する

オペレーション担当者は、コードを書かずに同じフローを進められます。

1. サインアップで、メールと6桁のコード、またはGoogleで登録します。
2. ウォレットにチャージします。
3. OTP Gatewayでパプアニューギニアとサービスを選び、価格を確認して確定します。
4. +675の番号をアプリに入力し、アクティベーションにコードが表示されるのを待ちます。

ブラウザからの注文とAPIからの注文は、1つのウォレットと1つのアクティベーション履歴を共有します。

反応のない+675アクティベーションのトラブルシューティング

すべてのアクティベーションは20分間続きます。SMSが届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。配信時間はサービスとルートによって異なるので、対応する前にウィンドウが終わるまで待ってください。

コードが来ない場合は次のようにします。

• アプリから再送を1回だけ実行し、待つ。
• 時間をおいて再試行するか、同じサービスで別のルートを使う。
• サービスが仮想番号を受け付けるか確認する。拒否するサービスもあり、そのため返金は自動で行われます。
• 自動化では再試行回数に上限を設け、注文の間に遅延を入れる。

各サービスの規約とOTP Routeの利用規定(Acceptable Use Policy)の範囲内でご利用ください。

長期回線、ウォレット、サンドボックス

パプアニューギニアには、セルフサービスの長期番号はありません。チームが継続的な+675回線を必要とする場合は、[email protected]までご連絡ください。提供可否は現地の規制によるため、お約束はできません。専用の仮想番号(Dedicated Virtual Numbers)はアメリカとカナダのみで、月額$1.95から販売しています。

ウォレットはUSDの前払いで従量課金、月額料金もプランもありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が発行されます。料金もご覧ください。開発用アカウントは依頼によりサンドボックスに切り替えられ、シミュレーションされた番号とコードが返されるため、PNGの連携を費用なしでエンドツーエンドにテストできます。

よくある質問

OTP Route APIでパプアニューギニアに使うIDは何ですか?

国IDは pg で、GET /api/v1/prices と POST /api/v1/activations で使います。

アプリの電話番号サインアップをテストするための+675番号を取得できますか?

はい。国 pg で対象サービスのアクティベーションを注文し、その番号をアプリに入力して、ダッシュボードまたはWebhookからコードを読み取ってください。

パプアニューギニアのSMS OTPを受信する費用はいくらですか?

1コード$0.20〜です。正確な価格はサービスによって異なり、注文前にリアルタイムで表示されます。

PNGの携帯番号には先頭のゼロが必要ですか?

いいえ。トランクプレフィックスがないため、E.164の携帯番号は+675に8桁を続けた形になります。

認証SMSはトク・ピジンで届く可能性が高いですか?

ほとんどありません。多くのサービスは+675番号に英語でコードを送りますが、パーサーは数字に基づいて解析してください。

PNGの番号を今後のログインのために保持できますか?

いいえ。Gatewayの番号は20分のウィンドウ内で1つのコードを扱うもので、セルフサービスの長期番号はアメリカとカナダにしかありません。

資金を使わずに連携を構築する方法はありますか?

はい。開発用アカウントでサンドボックスモードを依頼すれば、シミュレーションされた番号とコードを受け取れます。

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