服务目录
商品中心
账户余额$0.00
商品列表
编号商品单价最低数量最高数量说明
02 / 创建订单
批量下单
核对订单
预估总费用—
账户余额—
03 / 定期投放
循环下单
核对预扣费用
预扣总额—
账户余额—
04 / 订单记录
我的订单
05 / 资金记录
账单明细
当前余额$0.00
账户资金
充值
付款信息
- 充值单号
- 实际转账金额
- TRC20 地址
最近充值
开发者
API 接口
接口密钥
请立即保存，此密钥只显示一次。
API DOCS · V2
接口文档
使用同一账户余额、商品价格和订单记录。
请求方式POST
接口地址
https://yinliu.org/api/v2请求格式
application/x-www-form-urlencoded返回格式JSON
金额币种USD / U
每次请求传入 key 和 action。密钥仅用于服务端，不要放在网页前端或 URL 中。仅开放 Default 类型商品；补单与取消接口暂未开放。
01 / SERVICES
获取服务列表
返回可下单商品、数量范围和账户售价。rate 为每 1000 个的美元价格，不是单个价格。
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | 接口密钥 |
action | 是 | services |
请求示例
curl -X POST https://yinliu.org/api/v2 \
-d 'key=你的密钥' -d 'action=services'返回示例
[
{"service":101,"name":"Telegram 成员","type":"Default",
"category":"Telegram 成员","rate":"1.20000000",
"min":100,"max":10000,"refill":false,"cancel":false}
]02 / ADD
创建订单
提交后实时核价，扣除共享余额并返回本地订单号。金额以实际下单时价格为准。
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | 接口密钥 |
action | 是 | add |
service | 是 | 服务编号 |
link | 是 | 下单链接 |
quantity | 是 | 下单数量 |
request_id | 是 | 每笔订单一个 UUID；超时重试时保持不变 |
请求示例
curl -X POST https://yinliu.org/api/v2 \
-d 'key=你的密钥' -d 'action=add' \
-d 'service=101' -d 'link=https://t.me/example' \
-d 'quantity=1000' \
-d 'request_id=550e8400-e29b-41d4-a716-446655440000'返回示例
{"order":12345}同一个 request_id 重试只会返回同一订单，不会再次扣费。网络异常或返回“待核对”时，请勿使用新编号重复下单。
03 / STATUS
查询订单状态
使用返回的本地订单号查询。orders 支持逗号分隔，最多 100 个；不能与 order 同时传入。
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | 接口密钥 |
action | 是 | status |
order | 二选一 | 单笔本地订单号 |
orders | 二选一 | 多个本地订单号，逗号分隔 |
请求示例
curl -X POST https://yinliu.org/api/v2 \
-d 'key=你的密钥' -d 'action=status' -d 'order=12345'返回示例
{"charge":"1.20","refunded":"0.00","start_count":"0",
"status":"In progress","remains":"500","currency":"USD"}部分完成时 refunded 展示已退回金额。状态来自系统最近一次同步，不代表实时直查服务商。
04 / BALANCE
查询账户余额
| 参数 | 必填 | 说明 |
|---|---|---|
key | 是 | 接口密钥 |
action | 是 | balance |
请求与返回
curl -X POST https://yinliu.org/api/v2 \
-d 'key=你的密钥' -d 'action=balance'
{"balance":"12.34","currency":"USD"}ALTERNATIVE
REST 接口
现有接口继续可用。请求头传 Authorization: Bearer 你的密钥。金额字段以美分计，100 分 = 1U。
| 方法与路径 | 用途 |
|---|---|
GET /api/client/services | 分页商品列表 |
GET /api/client/services/{id} | 商品详情与说明 |
GET /api/client/balance | 账户余额 |
POST /api/client/order-quote | 下单前报价 |
POST /api/client/orders | 下单，需 Idempotency-Key 和报价金额 |
GET /api/client/orders/{id} | 订单状态与退款 |
报价示例
curl -X POST https://yinliu.org/api/client/order-quote \
-H 'Authorization: Bearer 你的密钥' \
-H 'Content-Type: application/json' \
-d '{"service_id":101,"link":"https://t.me/example","quantity":1000}'REFERENCE
错误与限流
出错时返回 HTTP 4xx/5xx 和 {"error":"错误原因"}。密钥无效为 401，参数无效为 400，订单不存在为 404，重复或待核对为 409，限流为 429，临时服务异常为 503。每个密钥每分钟最多 120 次请求，商品列表与下单合计最多 12 次。