はじめに
はじめに
esimoaのeSIM商品をサイト・アプリ・AIアシスタントに接続するREST APIとMCPサーバーのドキュメントです。
このページの内容
何が作れるか#
- 商品検索API — 国・期間・データ量でesimoaのeSIMを検索し、リアルタイム価格とともにサイトやアプリに表示できます。
- トラッキングリンク報酬 — APIレスポンスの購入リンクにはパートナーコードが付いています。そのリンク経由で決済されるとコミッションが貯まります。
- AI連携（MCP） — ChatGPT・Claude・GeminiにesimoaのMCPサーバーを接続すると、AIがeSIMを検索・比較し購入リンクを案内します。
- パートナーAPI（B2B） — 契約済みのB2B販売店・提携先は、サーバーからesimoaの商品カタログを取得して独自の販売画面を作れます。
どのAPIを使うべきか#
esimoaにはキーが異なる2つのREST APIがあります。ほとんどのサイト・ブログ・AIサービスは公開APIで十分です。
| 公開API（/v1） | パートナーAPI（B2B） | |
|---|---|---|
| 対象 | アフィリエイト — esimoa会員なら誰でも | 契約済みのB2B販売店・提携先 |
| キーの発行 | デベロッパーセンターのダッシュボード | パートナーポータル |
| キーの形式 | esk_live_<32> | esk_live_<10>_<40> |
| ベースURL | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| 収益モデル | レスポンスのトラッキングリンク経由の購入にコミッション | 契約条件による |
仕組み#
- 1esimoaアカウントでログインしサイト情報を入力すると、すぐにパートナーコードが発行されます。
- 2ダッシュボードでAPIキーを作成します。キーは作成時に一度だけ表示されます。
- 3APIで検索した商品とレスポンスのurl（パートナーコード付き）をサービスに掲載します。
- 4お客様がそのリンクで決済するとコミッションが貯まり、ダッシュボードで確認できます。