クイックスタート

はじめに

EvesesはSMS認証用の電話番号をオンデマンドで提供します。番号を予約し、ワンタイムコードを取得し、SMSが実際に届いた場合にのみ料金を支払います。

このページでは、最初のエンドツーエンドリクエストを3つのステップで案内します。

1. APIキーを作成

ログインして Account → API Keys を開きます。New key をクリックし、名前を付け（例：local-dev）、ダイアログに表示される値をコピーします。トークンは一度しか表示されません——すぐにパスワードマネージャーや .env ファイルに保存してください。

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. 番号を注文

国（ISO-2）とサービスslug（telegram、whatsapp、discord、any など）を選び、/v1/activations にPOSTします：

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "ua", "service": "telegram", "duration_minutes": 5}'

レスポンスには番号とアクティベーション id が含まれ、これでコードを取得します：

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"waiting","price_cents":50,"expires_at":"2026-05-26T14:35:00Z"}

3. SMSコードを読み取る

サードパーティサービスの認証フォームに番号を入力し、SMSが届くまでアクティベーションをポーリングします：

curl https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer $EVESES_API_KEY"

SMSが届くと、レスポンスにはOTPを含む sms 配列が入ります。ほとんどのプロバイダは30秒以内に配信します。期限までに何も届かなければ課金されません。

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"sms_received","price_cents":50,"expires_at":"2026-05-26T14:35:00Z","sms":[{"code":"123456","text":"Your code: 123456","received_at":"2026-05-26T14:30:14Z"}]}

次のステップ

• ポーリングをやめてWebhookを使う — activation.sms_received を購読すれば、OTPをプッシュ送信します。Webhooks セクションを参照。
• SDKを使う — PHP、JavaScript、Python、Goの公式ライブラリは SDKs に文書化されています。
• 冪等性について読む — 作成呼び出しを Idempotency-Key で包めば、リトライで二重課金されません。