SNSNumber

電話番号レンタルAPI

独自のコードから番号レンタル、受信SMSの閲覧、延長・キャンセルを実行。HTTPS経由のJSONで、コンソールから取得した1つのAPIキーを使用。

ベースURL
https://snsnumber.com/api/v1
認証
Authorization: Bearer snk_...
レート制限
キーあたり毎分300リクエスト

コンソールのAPI項目でキーを作成。価格は小数点以下2桁のUSドル文字列。時間はUTCのISO 8601形式。

エンドポイント

GET/balanceUSドルでのクレジット残高。
{ "balance": "120.00", "currency": "USD" }
GET/prices?country=us国、期間、価格。国を省略すると全件取得。
{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }
POST/rentals番号をレンタル。リクエストボディ：国と日数。
curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }
GET/rentals?state=activeレンタル番号一覧（新しい順、状態: 有効、期限切れ、キャンセル済み）
{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }
GET/rentals/{id}1つのレンタル番号とその受信ボックス
{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }
POST/rentals/{id}/extend有効なレンタル番号に期間を追加。本文: 日数
{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }
POST/rentals/{id}/cancelSMSが届いていない場合、20分以内なら全額返金
{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

エラー

エラーはHTTPステータスと{ "error": { "code", "message" } }を返します

ステータスコード意味
401no_key, bad_keyAPIキーがないか不正
402no_balanceクレジット不足
404not_foundレンタル番号が見つかりません
409ended, cancel_deniedレンタル期間終了、またはキャンセル期限を過ぎています
429rate_limited, too_many_active1分あたり300リクエスト、または20の有効番号まで
503network_errorしばらくしてから再試行してください
電話番号レンタルAPI: レンタル、受信ボックス、延長 | SNSNumber