邮箱验证（批量）

POST

/api/email/verify

type: "bulk_create"；必填 emails[]。可选 task_name、webhook_url。返回 task_id → 变量 emailTaskId。

请求参数

Header 参数

Body 参数application/json

示例

{
  "type": "bulk_create",
  "emails": [
    "a@example.com",
    "b@example.com"
  ],
  "task_name": "postman batch"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/email/verify' \
--header 'Authorization: Bearer {{apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "bulk_create",
  "emails": [
    "a@example.com",
    "b@example.com"
  ],
  "task_name": "postman batch"
}'

返回响应

🟢201成功

application/json

Body

示例

{
  "success": true,
  "request_id": "req_LSOanvBN53c",
  "type": "bulk_create",
  "task_id": "cmnzwtsjc00bs14dgb52nwllo",
  "reoon_task_id": "5465181",
  "status": "pending",
  "meta": {
    "billing": {
      "credits_charged": 0,
      "byok_used": false,
      "note": "Credits charged when bulk completes (0.1 per email)."
    }
  }
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

修改于 2026-04-15 12:05:58

邮箱验证（单个）

邮箱验证（批量结果）