eSIMfly MCP

開発者向けeSIM API：自社製品でeSIMを販売

1つのREST APIで、200カ国の卸売eSIMデータプランをアプリ、プラットフォーム、ストアに統合 — カタログ、注文、チャージ、利用状況、ライフサイクル管理のすべてをカバーします。

eSIM APIを活用する企業

企業は卸売eSIM統合を利用して、既存製品にコネクティビティ収益を追加しています。

旅行アプリ＆OTA

予約時にeSIMのアップセルを提供。旅行者は接続された状態で到着し、販売されたプランごとにマージンを確保できます。

リセラー＆MVNO

卸売レートでeSIMを調達し、自社のチャネルで独自の価格設定とパッケージングで販売します。

IoT＆フリートプラットフォーム

単一の統合で、国境を越えたデバイスや車両のコネクティビティをプロビジョニングおよび監視します。

スーパーアプリ＆フィンテック

決済、バンキング、ロイヤルティ製品に加えて、国際データプランをネイティブ機能として追加します。

API機能

eSIMをプログラムで運用するために必要なすべて

このAPIは、卸売パッケージの閲覧から現場でのeSIMのライブ管理まで、全行程をカバーします。

カタログ＆価格

200カ国の卸売価格で利用可能なすべてのデータパッケージを閲覧し、注文前にアカウント残高を確認できます。

全パッケージ取得残高照会

注文＆チャージ

新しいeSIMを即座にプロビジョニングし、既存のeSIMにチャージします。注文はQRコードとアクティベーション詳細を返し、ユーザーに配信する準備が整います。

注文作成パッケージ＆注文のチャージ

eSIMライフサイクル

発行したすべてのeSIMを管理：ステータスとデータ使用量の確認、回線の停止またはキャンセル、ネットワークイベントの確認、SMSの送信。

eSIMの一覧／照会eSIMステータスキャンセル／停止／アクティベート利用状況レポートネットワークイベントSMS送信

Webhook

エンドポイントを登録して、注文およびeSIMライフサイクルイベントのリアルタイム通知を受信 — ポーリングは不要です。

Webhook管理イベント通知

卸売eSIMレート、あなたのマージン

APIパートナーは卸売価格でデータパッケージを購入し、独自の小売価格を設定します。カタログは200カ国、450以上のネットワークにわたるローカル、リージョナル、グローバルプランを網羅しているため、1つの統合でユーザーが旅行するすべての目的地をカバーできます。残高ベースの請求により決済はシンプル：アカウントに資金を入金し、各注文は卸売レートでそこから引き落とされます。

独自のストアフロントを構築する代わりに完全なストアフロントが必要な場合は、ホワイトラベルeSIMリセラープラットフォームが同じインフラストラクチャ上にブランド化されたウェブサイト、ダッシュボード、モバイルアプリを提供します。

セキュリティ設計：HMAC署名リクエスト

すべてのAPI呼び出しは、リクエストタイムスタンプ、一意のリクエストID、アクセスコード、リクエストボディに対するHMAC-SHA256署名で認証されます — 整合性検証とリプレイ攻撃防止を提供します。Node.js、Python、PHP用の既製署名例はドキュメントに記載されています。

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

3ステップでAPIアクセスを取得

1. ビジネスアカウントを作成

eSIMflyビジネスアカウントにサインアップし、ユースケースと想定ボリュームをお知らせください。

2. APIキーを生成

ビジネスダッシュボードからアクセス認証情報を作成および管理し、残高に入金します。

3. 統合して開始

ドキュメントに従ってパッケージを閲覧し、テスト注文を実行し、必要に応じて非同期プロビジョニングされるeSIM用のwebhookを登録します。

FAQ

eSIM APIに関する質問への回答

eSIMfly eSIM APIとは何ですか？+

eSIMfly APIは、卸売レートでeSIMをプログラム的に購入、プロビジョニング、管理できるREST APIです。パッケージカタログの閲覧、注文作成、プランのチャージ、使用量の監視、eSIMライフサイクル全体（アクティベート、停止、キャンセル）の管理を自社アプリケーションから行え、200カ国、450以上のネットワークをカバーしています。

eSIM APIは誰向けですか？+

このAPIは、eSIMコネクティビティを自社製品に組み込みたい企業向けに構築されています：旅行アプリや予約プラットフォーム、通信リセラーやMVNO、IoTやフリートプラットフォーム、そしてキャリアとの直接関係を構築せずにユーザーに国際データを提供したいあらゆるサービスが対象です。

API認証はどのように機能しますか？+

リクエストはHMAC-SHA256署名で認証されます。各リクエストにはアクセスコード、一意のリクエストID、タイムスタンプ、シークレットキーで計算された署名が含まれ、リクエストの整合性検証を提供し、リプレイ攻撃を防止します。Node.js、Python、PHPのコード例はドキュメントで入手できます。

eSIM APIアクセスを取得するには？+

eSIMflyビジネスアカウントを作成し、ビジネスダッシュボードからAPIキーを生成します。卸売価格帯はボリュームによって異なります — 想定される注文ボリュームのレートについて、営業チームにお問い合わせください。

APIはwebhookをサポートしていますか？+

はい。Webhookは、非同期でプロビジョニングされるeSIMの準備ができたときに通知します — 一部のキャリア（KDDI日本など）は数分かかりますが、ポーリングの代わりにeSIM詳細を含む署名付きPOSTを受信します。ほとんどのプロバイダーは注文応答で同期プロビジョニングし、ステータスと使用量はステータスおよび使用量エンドポイントで照会されます。

APIのレート制限は？+

APIはアカウントあたり1時間に1,000リクエストを許可します。5分以上前のリクエストはリプレイ攻撃防止の一環として拒否されます。統合に高い制限が必要な場合は、営業にお問い合わせください。

公式SDK · NODE.JS / TYPESCRIPT

署名コードをスキップ — SDKをインストール

npm install @esimfly/sdkはAPI全体への型付きアクセスを提供します — HMAC署名、新しいリクエストID、冪等な注文、ペース調整されたカタログ同期、webhook署名検証が組み込まれています。依存関係ゼロ、Node.js 18+、MITライセンスのオープンソースです。PHPおよびPython SDKは今後提供予定です。

AIエージェントを使用していますか？ホスト型MCPサーバー https://mcp.esimfly.net/mcp をClaude、ChatGPT、Cursorに追加し、ビジネスアカウントでサインイン — キーの貼り付けは不要です。プランの検索、使用量の確認、ライブAPIに対するeSIMの診断が可能。デフォルトは読み取り専用で、注文前には確認ステップがあります。ローカルがお好みですか？ npx -y @esimfly/mcp。

統合チュートリアル

最初のリクエストから本番webhookまで、動作するNode.jsコード。

[

ここから始める · アーキテクチャガイド

eSIM API統合ガイド

4つの構成要素、署名付き認証、同期vs webhookプロビジョニング、プロバイダー評価チェックリスト、そして本番環境でのみ顕在化する落とし穴。

ガイドを読む](https://esimfly.net/esim-api/integration-guide)

[

パート1 · 約30分

Node.jsでアプリにeSIMを販売

HMAC認証、パッケージカタログ、注文作成、QRコード配信 — 完全に動作するストアフロント。

チュートリアルを開始](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

パート2 · ライフサイクル

チャージ、使用量追跡＆Webhook

ライブ使用量クエリ、既存eSIMへのチャージ販売、ポーリングなしの署名付きwebhook。

パート2に進む](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

製品にeSIMを統合する準備はできましたか？

ドキュメントから始めるか、ボリュームに応じた卸売レートについてチームにご相談ください。