API

认证

从 仪表板 → API Token生成个人 API Token。在每个请求的 Bearer Header 中包含它：

Authorization: Bearer <your-token>

基础 URL

https://api.otpfactory.com

端点

• GET/v1/services列出支持的服务及当前按国家计价。
• GET/v1/countries列出库存活跃的国家。
• POST/v1/ordersapiPage.endpoints.items.createOrder
• GET/v1/orders/:idapiPage.endpoints.items.getOrder
• DELETE/v1/orders/:id取消活跃订单。如未收到 SMS 则退款至钱包。
• POST/v1/paymentsapiPage.endpoints.items.createPayment
• GET/v1/wallet获取当前钱包余额和最近交易。
• GET/v1/rentals列出活跃的长期租赁。

快速开始

curl -X POST https://api.otpfactory.com/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

速率限制

• • 订单下单：30 次请求 / 分钟 / Token
• • 订单轮询：120 次请求 / 分钟 / Token
• • 支付 / 充值：10 次请求 / 小时 / Token
• • 全局每 IP 限制：120 次请求 / 分钟（无 Token 也适用）

达到限制返回 HTTP 429，带有 Retry-After Header。