开发者文档
号码检测 API：上传文件、创建任务、取回结果
快速开始
五分钟跑通第一个任务
01
在控制台生成 API Key
登录后进入 API Keys 页面创建，密钥只在创建时完整显示一次。
02
申请上传地址并上传文件
接口返回一个预签名地址，文件直传对象存储，不经过我们的应用服务器。
03
创建任务
提交产品 ID 与文件路径，系统按实际有效数量计费。
04
轮询状态并下载结果
任务完成后可取 zip、CSV 或纯号码清单。
基地址
https://api.geeknums.io所有路径均含 /api 前缀，签名时也必须包含它。
接口总览
GET
/api/open/v1/account账号资料与余额GET
/api/open/v1/products可用产品、单价、数量范围与国家要求GET
/api/open/v1/files/upload-url申请文件上传地址（预签名）POST
/api/open/v1/tasks创建检测任务GET
/api/open/v1/tasks任务列表GET
/api/open/v1/tasks/{id}任务详情（轮询判断完成）GET
/api/open/v1/tasks/{id}/result完整结果包 zipGET
/api/open/v1/tasks/{id}/result-csv整份结果 CSV（稳定标识值）GET
/api/open/v1/tasks/{id}/activated已激活号码清单GET
/api/open/v1/tasks/{id}/invalid无效数据清单