1. 認証
すべてのリクエストに X-API-Key ヘッダー（管理画面の B2B API で発行）、または有効な有料プランの会員アカウントの Authorization: Bearer <token> ヘッダーが必要です。どちらもない場合、キーが誤っている/無効な場合、トークンの有効期限が切れている場合は HTTP 401 で拒否されます。
2. IMEI チェック
GET /api/v3/{キャリア}/{imei} — 日本のキャリア1社における IMEI のネットワーク利用制限状況を返します。{キャリア} は下の表のコードのいずれか、{imei} は Luhn チェックが正しい15桁です。複数キャリアを照会する場合はコードごとに順番に呼び出してください。結果: {"message": "<記号>"}。
3. Samsung 照会
GET /api/v3/samsung/{imei} — IMEI から Samsung 端末の情報（モデルなど）を返します。
4. エラーコード
HTTP 401 {"message":"Thiếu hoặc sai API key / token"}: 未認証。HTTP 403（会員トークン使用時のみ）: アカウントがロック・無効化・未有効化・メール未確認・Free プラン・プラン期限切れのいずれか — code フィールドに理由が入ります（BLOCKED、DISABLED、INACTIVE、NOT_VERIFIED、NO_PLAN、EXPIRED）。HTTP 400 {"message":"IMEI Error"}: IMEI が15桁でないか Luhn チェックが不正です。HTTP 500 {"message":"error"}: キャリアのサイトから結果を取得できませんでした — 数分後に再試行してください。メンテナンス中は message にメンテナンスのお知らせが含まれる場合があります。
5. 制限
キーごとのリクエスト数制限はありません。各リクエストはキャリアのサイトを直接照会するため数秒かかる場合があります — タイムアウトは60秒以上に設定し、同時に大量に呼び出さないでください。すべてのリクエストは IP とともに記録されます。