分销 API

单一接口地址，一个带 key 和 action 字段的表单。兼容标准 SMM 面板 API v2——现成的商店与计费模块无需改动即可接入。

快速开始

地址: https://telegos.app/api/v2
方法: POST
请求体格式: application/x-www-form-urlencoded
响应: JSON，始终带 status 200

密钥通过请求体中的 key 字段传递——这里不使用 Authorization 请求头。个人中心使用独立的令牌，因此重置密钥不会结束您的浏览器会话。

服务列表

返回完整价目：用于 action=add 的服务 id、每 1000 单位的价格以及数量上下限。

字段	取值
`key`	您的密钥
`action`	services

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=services

响应

[
  {
    "service": 101,
    "name": "Telegram Members · CIS",
    "type": "Default",
    "category": "Telegram Members",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

创建订单

立即从余额扣款，并返回订单编号。

字段	取值
`key`	您的密钥
`action`	add
`service`	来自 action=services 的服务 id
`link`	频道、帖子或主页的链接
`quantity`	min…max 范围内的订单数量

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=500

响应

{
  "order": 23501
}

分批发放订单

字段相同，另加两个：发放批次数和批次间隔。此处 quantity 是单批的数量，扣款按所有批次的总量计算。

字段	取值
`runs`	批次数
`interval`	批次间隔，单位分钟

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=100 \
  -d runs=5 \
  -d interval=60

响应

{
  "order": 23502
}

订单状态

start_count 是起始计数，remains 是尚未交付的数量。

字段	取值
`key`	您的密钥
`action`	status
`order`	订单编号

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=23501

响应

{
  "charge": "0.4500",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}

批量查询订单状态

每次请求最多 100 个编号。响应是以订单编号为键的对象：不存在的编号会带 error 返回，且不影响其余结果。

字段	取值
`key`	您的密钥
`action`	status
`orders`	用逗号分隔的编号

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=23501,23502,999999

响应

{
  "23501": {
    "charge": "0.4500",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "0.9000",
    "start_count": "1204",
    "status": "In progress",
    "remains": "300",
    "currency": "USD"
  },
  "999999": {
    "error": "Incorrect order ID"
  }
}

补量

仅在服务返回 refill: true 时可用。补量进度通过单独的 refill_status 操作按其编号查询。

字段	取值
`key`	您的密钥
`action`	refill / refill_status
`order`	订单编号——用于 refill
`refill`	补量编号——用于 refill_status

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=23501

响应

{
  "refill": 412
}

取消

仅在服务返回 cancel: true 时可用。已取消订单的金额退回余额。

字段	取值
`key`	您的密钥
`action`	cancel
`orders`	用逗号分隔的编号

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=23501,23502

响应

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]

余额

字段	取值
`key`	您的密钥
`action`	balance

请求

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=balance

响应

{
  "balance": "19.61",
  "currency": "USD"
}

订单状态

状态	含义
`Pending`	订单已接收，等待发送给供应商
`In progress`	正在交付
`Processing`	订单正在供应商侧处理
`Completed`	数量已全部交付
`Partial`	部分数量已交付，其余退回余额
`Canceled`	订单已取消，扣款已退回

错误

错误同样以 200 状态码返回，只以是否存在 error 字段区分：请检查响应体，而不是 HTTP 状态。批量操作中，错误只出现在对应的元素内，不影响其余部分。

响应

{
  "error": "Incorrect request"
}