快速开始

简介

Eveses 按需提供用于 SMS 验证的电话号码。你申请一个号码，获取一次性验证码，只有在 SMS 真正到达时才付费。

本页面将通过三个步骤引导你完成第一次端到端请求。

1. 创建 API 密钥

登录后打开 Account → API Keys。点击 New key，命名（例如 local-dev），并复制对话框中显示的值。Token 只显示一次——立刻保存到密码管理器或 .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 包装创建调用，避免重试导致重复扣费。