non-voip 商户 API v1

Base URL 与身份验证

快速开始

1. 在 API Dashboard 中创建商户 API 密钥，并仅保存在服务器上。创建、轮换和使用密钥均需要有效的 merchant 套餐。
2. 每个请求都发送 X-Api-Key。
3. 读取目录，然后使用其中的 productServiceId 和唯一 Idempotency-Key 创建验证。
4. 轮询验证，直到 data.messages 包含验证码。单条短信服务通常进入 completed，而不是 otp_received。

export NV_API_KEY='nvr_live_...'
API='https://non-voip-api.0246864.xyz/api/v1'

PRODUCT_SERVICE_ID=$(curl --fail-with-body --silent --show-error   "$API/catalog?test=true"   -H "X-Api-Key: $NV_API_KEY" | jq -r '.data[0].productServiceId')

VERIFICATION_ID=$(curl --fail-with-body --silent --show-error   -X POST "$API/verifications?test=true"   -H "X-Api-Key: $NV_API_KEY"   -H "Idempotency-Key: $(uuidgen)"   -H "Content-Type: application/json"   -d "{"productServiceId":"$PRODUCT_SERVICE_ID"}" | jq -r '.data.verificationId')

for _ in $(seq 20); do
  curl --fail-with-body --silent --show-error --max-time 15     "$API/verifications/$VERIFICATION_ID?test=true"     -H "X-Api-Key: $NV_API_KEY" | jq -e '.data.messages[0].code' && break
  sleep 5
done

生产集成要点

测试模式（不会真实扣费）

添加 ?test=true 可获得与生产一致的确定性数据，且不会调用供应商或扣除余额。身份验证、请求日志和限流仍然生效。

Webhook 通知

Payload 示例

{
  "event": "verification.completed",
  "timestamp": "2026-08-27T10:00:00.000Z",
  "balance": 124.5,
  "data": {
    "subscriptionId": "550e8400-e29b-41d4-a716-446655440000",
    "phoneNumber": "+15550001234",
    "otpCode": "483920",
    "messages": [
      {
        "code": "483920",
        "message": "Your verification code is 483920",
        "receivedAt": "2026-08-27T09:59:58.000Z"
      }
    ],
    "status": "completed",
    "productServiceId": "0f1a5a6c-1c2d-4f2b-9a1e-3c9d4b7e2f10"
  }
}

商户 - 余额

商户 - 目录

商户 - 验证

资源