数字方舟
Digital Ark

API 文档

申请 API
当前版本 1.0.1·更新 2026-07-04·Base URL https://api.da.9094.cc

认证说明

所有 API 请求都需要在请求头中携带认证令牌。

参数名token
类型String
必填是
说明认证令牌，审核通过后由运营发放
GET /api/user/balance HTTP/1.1
Host: api.da.9094.cc
token: your_token_here

通用响应格式

成功响应

{
  "code": 0,
  "message": "success",
  "data": { }
}

失败响应

{
  "code": 1,
  "message": "错误描述信息"
}
code: 0请求成功
code: 1请求失败

API 接口列表

GET查询账号余额

查询当前账号的可用余额（单位：积分）

接口地址: GET /api/user/balance

请求参数: 无需额外参数，通过 token 自动识别账号

响应示例:

{
  "code": 0,
  "message": "success",
  "data": {
    "balance": 100.0
  }
}
balance当前账号余额(积分)

POST提交任务

创建并提交一个新的筛选任务

接口地址: POST /api/task/create

Content-Type: multipart/form-data

请求参数:

file必填 — 任务文件，仅支持 txt 格式
country必填 — 地区编码（如：US-美国，DE-德国）。邮箱检测类无需传
taskType必填 — 任务类型，详见任务类型列表
taskName可选 — 自定义任务名称

响应示例:

{
  "code": 0,
  "message": "任务创建成功",
  "data": {
    "taskId": "WS250905164942",
    "country": "US",
    "taskTotal": 485,
    "taskState": "Waiting"
  },
  "consume": {
    "deduction": 0.119,
    "balance": 491.892
  }
}

响应参数:

data.taskId任务ID，后续查询进度和下载结果时使用
data.country任务所属地区编码
data.taskTotal任务总数量
data.taskState任务状态，初始通常为 Waiting
consume.deduction本次任务扣费积分
consume.balance扣费后账户剩余积分

GET获取任务进度

查询指定任务的执行进度和状态

接口地址: GET /api/task/progress

请求参数:

taskId必填 — 任务ID（创建任务时返回的 taskId）

请求示例:

GET /api/task/progress?taskId=WS250905164942

响应示例:

{
  "code": 0,
  "message": "success",
  "data": {
    "taskId": "PA260426095209979",
    "taskName": "3869514995format",
    "country": "US",
    "taskTotal": 4973,
    "taskProgress": 4973,
    "validQuantity": 264,
    "taskState": "Finish"
  }
}

响应参数:

data.taskId任务ID
data.taskName任务名称
data.country任务地区编码
data.taskTotal任务总数量
data.taskProgress当前已处理数量
data.validQuantity当前有效数量
data.taskState任务状态（Pending/Waiting/Ongoing/Finish/Fail/Close）

GET下载结果文件

下载已完成任务的结果文件

接口地址: GET /api/task/result

请求参数:

taskId必填 — 任务ID（创建任务时返回的 taskId）

响应说明: 返回文件流，响应头包含文件信息

任务类型列表

WhatsApp 筛选

wsValid-WS筛开通wsActive-WS筛活跃wsGender-WS性别年龄-全格式

Telegram 筛选

tgValid-TG筛开通tgActive-TG筛活跃tgGender-TG性别年龄-全格式tgNameValid-TG筛用户名

社交媒体筛选

fbValid-Facebook筛开通fbGender-Facebook筛性别fbUid-Facebook筛UIDinsValid-Instagram筛开通linkedinValid-领英筛开通linkedinGender-领英筛全格式tiktokUser-Tiktok筛用户名twitterValid-Twitter筛开通snapchatValid-Snapchat筛开通

通讯工具筛选

lineValid-Line筛开通lineGender-Line筛性别年龄signalValid-Signal筛开通viberValid-Viber筛开通viberGender-Viber筛性别年龄viberActive-Viber筛活跃botimValid-Botim筛开通botimGender-Botim筛性别年龄zaloValid-Zalo筛开通zaloGender-Zalo筛性别年龄zaloGenderQuick-Zalo极速筛性别年龄zaloActive-Zalo筛活跃wxValid-WeChat筛开通rcsSystem-RCS筛系统

其他服务

amazonValid-亚马逊筛开通teamsValid-Teams筛开通sidelineValid-Sideline筛开通dhlValid-DHL筛开通

交易所

binanceValid-币安筛开通okxValid-OKX筛开通htxValid-HTX筛开通kucoinValid-Kucoin筛开通coinwValid-Coinw筛开通mexcValid-MEXC筛开通

号码检测

iosBlueValid-IOS筛蓝号iosValid-IOS筛系统phoneCheck-空号检测operatorStandard-运营商检测numberStatus-手机型号检测phoneActive-号码活跃检测phoneUsCarrier-高级美国运营商检测phoneRoaming-号码开关机状态检测phoneDnd-勿扰号码检测（仅支持美国 US）

邮箱检测

fbEmail-Facebook邮箱检测insEmail-Instagram邮箱检测amazonEmail-Amazon邮箱检测twitterEmail-Twitter邮箱检测

上传 txt 文件，每行一个邮箱地址；无需传 country 参数。无效行（不含 @ 或 .）会在服务端自动剔除，同文件内邮箱忽略大小写去重。

任务状态说明

Pending排队中 — 任务已提交，等待系统分配资源
Waiting待执行 — 任务已创建，即将开始执行
Ongoing执行中 — 任务正在执行
Finish已完成 — 可下载结果
Fail执行失败 — 会立即自动退款
Close已关闭 — 请联系管理员

错误码说明

token不能为空或无效请检查 token 是否正确，或联系管理员重新获取
参数错误检查必填参数是否都已提供，格式是否正确
余额不足账号积分不足以执行任务，请充值后重试
任务不存在指定的 taskId 不存在，检查 taskId 是否正确
无权访问该任务只能访问自己创建的任务
文件不存在或已被删除结果文件不存在，可能任务未完成或文件已过期

使用示例 (cURL)

1. 查询余额

curl -X GET "https://api.da.9094.cc/api/user/balance" \
  -H "token: your_token_here"

2. 提交任务

curl -X POST "https://api.da.9094.cc/api/task/create" \
  -H "token: your_token_here" \
  -F "file=@/path/to/your/file.txt" \
  -F "country=US" \
  -F "taskType=wsValid" \
  -F "taskName=测试任务"

2.1 提交邮箱检测任务（示例）

curl -X POST "https://api.da.9094.cc/api/task/create" \
  -H "token: your_token_here" \
  -F "file=@/path/to/emails.txt" \
  -F "taskType=fbEmail" \
  -F "taskName=Facebook邮箱检测"

3. 查询任务进度

curl -X GET "https://api.da.9094.cc/api/task/progress?taskId=WS250905164942" \
  -H "token: your_token_here"

4. 下载结果文件

curl -X GET "https://api.da.9094.cc/api/task/result?taskId=WS250905164942" \
  -H "token: your_token_here" \
  -O -J

注意事项

安全性

  • 请妥善保管您的 token，不要泄露给他人
  • 建议通过 HTTPS 协议访问 API
  • 定期更换 token 以提高安全性

文件要求

  • 任务文件必须是 txt 格式
  • 文件编码建议使用 UTF-8
  • 单个文件大小建议不超过 100 万行
  • 号码类任务：每行一个号码，含国际区号，不含 + 号
  • 邮箱检测类（fbEmail / insEmail / amazonEmail / twitterEmail）：每行一个邮箱，须同时包含 @ 与 .

任务执行

  • 任务提交后会立即扣除相应积分
  • 任务完成后才能下载结果文件
  • 结果文件保留时间为 30 天

频率限制

  • 建议单个账号并发任务数不超过 10 个
  • 查询接口建议间隔不少于 1 秒
  • 批量操作建议使用任务进度接口轮询，避免频繁请求