開発者向け API リファレンス

シンプルな HTTP GET リクエストでテスト用電話番号をプログラム的に一括生成。

エンドポイント

以下の URL に HTTP GET リクエストを送信します：

GEThttps://phone-number.loveyouall.qzz.io/api/generate

オンラインテスト (Try It)

下のパラメータを入力して、実際の API を直接呼び出し JSON レスポンスを確認。

パラメータ: country

quantity

safetyMode

region

city

クエリパラメータ

パラメータ	型	必須	説明
`country`	string	いいえ	国コード。"US"、"CN"、"CA"、"GB"、"AU"、"DE"、"FR"、"JP"、"KR"、"IN"、"SG"、"ES"、"IT"、"BR"、"MX"、"RU"、"NL" に対応。デフォルトは "US"。
`region`	string	いいえ	州/省/事業者名（例："California"、"Ontario"、"中国移動"）。大文字小文字を区別しません。
`city`	string	いいえ	都市名または 3 桁/2 桁の特定プリフィックス（例："Los Angeles"、"138"）。大文字小文字を区別しません。region の指定が必要です。
`quantity`	integer	いいえ	生成する番号の件数。範囲: 1〜1000（1000 を超えると切り捨て）。デフォルト: 10。
`customPrefix`	string	いいえ	カスタムプリフィックス数字（0-9 の数字のみ）。任意。
`safetyMode`	string	いいえ	安全モード。"realistic"（実際の規則）と "safe"（公式の架空テスト番号、例: 555-XXXX）に対応。デフォルトは "realistic"。
`uniqueOnly`	boolean	いいえ	一意な番号のみ生成するかどうか。"true" または "false"。デフォルトは "true"。

コード統合例

お好みの言語やツールを選択して生成 API を統合できます：

curl -X GET "https://phone-number.loveyouall.qzz.io/api/generate?country=US&quantity=5&safetyMode=safe&uniqueOnly=true"

レスポンス形式

電話番号レコードの JSON 配列を返します。各レコードにはローカライズ済みフィールド、表示形式、標準 E.164 文字列が含まれます。

[
  {
    "id": "c852d129-4112-4981-8ddb",
    "country": "US",
    "region": "California",
    "regionCode": "CA",
    "city": "Los Angeles",
    "areaCode": "213",
    "display": "+1 (213) 932-8419",
    "e164": "+12139328419"
  }
]

レスポンスフィールド

フィールド	型	説明
`id`	string	レコードの一意な UUID v4 識別子。
`country`	string	2 文字の国コード（例: US、CN）。
`region`	string	州 / 省 / 事業者名（例: California、中国移動）。
`regionCode`	string	存在する場合の州/省の 2 文字コード（例: CA=カリフォルニア）。
`areaCode`	string	市外局番またはプリフィックス（例: 213、138）。
`city`	string	都市名または番号帯（例: Los Angeles、138）。
`display`	string	人が読みやすい形式の番号（例: +1 (213) 555-1234）。
`e164`	string	標準 E.164 形式（例: +12135551234）。

エラーコード

API は標準 HTTP ステータスコードを使用し、失敗時は常に "error" フィールドを含む JSON を返します。

ステータスコード	発生条件	レスポンスボディ
`400`	サポートされていない国コード	`{"error":"Unsupported country code: XX"}`
`400`	選択した国に存在しない州/省または都市	`{"error":"Unknown region ... for country US"}`
`400`	customPrefix に数字以外の文字が含まれています	`{"error":"customPrefix must contain digits only"}`
`400`	region を指定せずに city が渡されました	`{"error":"city requires region"}`
`500`	生成中に内部エラーが発生しました	`{"error":"Internal Server Error"}`

利用制限

無料・認証不要、API キーは不要
1 リクエストあたり最大 1000 件（超過分は切り捨て）
デフォルト: country=US、quantity=10、safetyMode=realistic、uniqueOnly=true
safetyMode=safe は公式の架空テスト番号帯（例: 555-XXXX）を使用するため、実在ユーザーにはかかりません