简体中文
Cappi-Services

分销商 API 文档

以分销商价格,在您自己的面板中销售我们的 Steam 服务。

通过简单的 HTTP 请求即可创建订单、跟踪交付进度并查询余额。所有响应均为 JSON,所有价格均以 USD 计。

通过 API 下的订单可在面板价格基础上享受 20% 的折扣。下方价格已包含该折扣。

基础 URL

https://cappiservices.com/api/Reseller

您的 API 密钥位于客户面板的 API Key 页面。创建新密钥后,旧密钥会立即失效。 打开 API Key 页面

测试与使用

您可以使用 Swagger UI 测试和调用 API:

https://cappiservices.com/swagger

身份验证

除 ServicesList 外,所有请求都需要您的 API 密钥。可通过以下三种方式之一发送:

2026 年 11 月之前创建的密钥可能包含 + 和 /:通过查询字符串发送时请对其进行 URL 编码,否则 + 会变成空格,导致密钥被拒绝。新密钥为 64 位十六进制字符,无需编码。

请求与响应

参数可放在查询字符串或表单请求体(POST)中。成功时返回 HTTP 200;业务错误返回 HTTP 400,并带有 error 字段(RegisterOrder 还会将 success 设为 false)。订单被拒绝时不会扣款。

每个 IP 地址每 1 分钟最多 120 次请求。超出限制时,API 将返回 HTTP 429 并附带 Retry-After 响应头。

服务

此表为实时数据:价格已包含您的折扣,max 为当前可用数量(取决于我们的账号库存)。标记为不可用的服务在恢复之前,RegisterOrder 会拒绝该服务;ServicesList 的 active 字段中也有相同的信息。

ID 服务 类型 单价 最小 / 最大 状态
199825
Steam Like SharedFiles/Screenshots/Guides/Workshop

link: 截图、艺术作品、指南或创意工坊物品的 URL:steamcommunity.com/sharedfiles/filedetails/?id=...(或 /workshop/filedetails/?id=...)。

Default $ 0.0152 1 / 4797 可用
199826
Steam Favorite SharedFiles/Screenshots/Guides/Workshop

link: 截图、艺术作品、指南或创意工坊物品的 URL:steamcommunity.com/sharedfiles/filedetails/?id=...(或 /workshop/filedetails/?id=...)。

Default $ 0.0152 1 / 4797 可用
199827
Steam Group Members

link: 公开组 URL:steamcommunity.com/groups/yourgroup。该组必须为公开。

Default $ 0.02 1 / 5467 可用
199828
Steam Workshop Followers

link: 创意工坊作者的 SteamID64(17 位数字,例如 76561198307708414)或 steamcommunity.com/profiles/SteamID64。不接受自定义 URL(/id/name)。

Default $ 0.012 1 / 4797 可用
199829
Steam Curator Followers

link: 鉴赏家页面:store.steampowered.com/curator/12345678-Name/。

Default $ 0.024 1 / 5467 可用
199830
Steam Game Review Rate Up (helpful votes)

link: 评测 URL:steamcommunity.com/id/user/recommended/appid/ 或 steamcommunity.com/profiles/SteamID64/recommended/appid/。投票始终为"有用"(Rate Up)。

Default $ 0.012 1 / 4797 可用
199831
Steam Trade Boost (trade offers, 1 gem each)

link: 接收账号的 Steam 交易链接:steamcommunity.com/tradeoffer/new/?partner=...&token=... 库存必须为公开;每个单位为一个包含 1 个宝石的交易报价。

Default $ 0.0022 1 / 1000 可用
199832
Steam Profile Comments (ready-made packages)

link: 个人资料的 SteamID64(17 位数字)或 steamcommunity.com/profiles/SteamID64。该个人资料必须允许评论。评论来自我们预设的评论包(必填的 package 参数)。

可选参数:package

Default $ 0.0264 1 / 10000 可用
199833
Steam Screenshot/Artwork/Workshop Comments (ready-made packages)

link: 截图、艺术作品或创意工坊物品的 URL(steamcommunity.com/sharedfiles/filedetails/?id=...)。评论来自我们预设的评论包(必填的 package 参数)。

可选参数:package

Default $ 0.0264 1 / 10000 可用
199834
Steam Group Comments (ready-made packages)

link: 公开组 URL:steamcommunity.com/groups/yourgroup。评论来自我们预设的评论包(必填的 package 参数)。

可选参数:package

Default $ 0.0264 1 / 10000 可用
199835
Steam Profile Comments (your own comments)

link: 个人资料的 SteamID64 或 steamcommunity.com/profiles/SteamID64,并在 comments 参数中提供您自己的评论(每行一条)。可选 delay 参数。

可选参数:delay, comments_json, package, allow_partial

Custom Comments $ 0.0264 1 / 10000 可用
199836
Steam Screenshot/Artwork/Workshop Comments (your own comments)

link: 截图、艺术作品或创意工坊物品的 URL,并在 comments 参数中提供您自己的评论(每行一条)。可选 delay 参数。

可选参数:delay, comments_json, package, allow_partial

Custom Comments $ 0.0264 1 / 10000 可用
199837
Steam Group Comments (your own comments)

link: 公开组 URL,并在 comments 参数中提供您自己的评论(每行一条)。可选 delay 参数。

可选参数:delay, comments_json, package, allow_partial

Custom Comments $ 0.0264 1 / 10000 可用

评论服务

官方评论包:在 package 参数中使用 lib:<id>。点击名称查看其中的评论:

在预设评论服务中,package 参数为必填。它接受 cat:<category>[:<language>](我们评论库中某一分类的已审核评论;不指定语言时为英文以及不含文字的评论)和 lib:<id>(官方或已发布的评论库包,或你自己的包;每个订单最多 10 个)。多个值用逗号分隔:订单会从中随机选取最多 quantity 条不同的评论(每条评论一条,不重复),并且至少需要 5 条评论。

评论库类别:

cat:praise Compliments cat:friendly Greetings & Wishes cat:funny Funny cat:game Skill & Gameplay cat:counter_strike Counter-Strike cat:teammate Teammates & GG cat:rep +Rep (gameplay) cat:emoji Emoji cat:ascii_art ASCII Art cat:birthday Birthday cat:halloween Halloween cat:christmas Christmas cat:new_year New Year cat:valentines Valentine's Day cat:festive Other Holidays cat:toxic Toxic cat:spicy Spicy (18+) cat:other Other

语言代码:en, pt, es, ru, tr, de, pl, zh, ja, fr, it, ko, uk, ar, th, vi, id, ms, tl, hi, he, cs, sk, nl, hu, ro, sv, da, fi, no, el, bg, sr, none, other(none = 不含文字的评论,例如表情符号)。

自定义评论(comments 参数):每行一条评论,最多 500 行,每行最多 1000 个字符。空行会被忽略。请通过表单请求体发送,不要放在 URL 中。

自定义评论服务只接受一种来源:comments(每行一条评论,同上)、comments_json(仅限表单正文:字符串组成的 JSON 数组,每项一条评论;保留换行和缩进;每条评论最多 999 字节、30 行,quantity 最多为不同评论数量的 25 倍)或 package=lib:<id>(你自己的私有评论库包,用逗号分隔)。

每条自定义评论都会在创建订单前审核。只拒绝诈骗类内容:交易或信誉评价、链接、Steam 以外的联系方式、冒充 Valve 或 Steam 客服、虚假抽奖或广告、真实个人信息以及涉及未成年人的色情内容。玩笑、脏话、毒舌或成人内容都允许。只要有评论未通过,订单就会被拒绝且不会扣款;发送 allow_partial=1 可只用已通过的评论继续下单(价格不变)。不同评论数量多于 quantity 的 comments_json 列表会被随机抽样截取(truncatedComments)。

delay 参数(仅限自定义评论):两条评论之间的间隔。可接受的值:10 Seconds, 7 Minutes, 15 Minutes, 30 Minutes, 1 Hour, 3 Hours, 6 Hours。默认值:10 Seconds。每条评论的价格取决于所选间隔;表中的 rate 为 10 Seconds 的价格。

接口

GET /ServicesList

获取所有服务的列表,包含 ID、单价、数量限制以及 link 的填写方式。 无需身份验证。

请求示例

curl "https://cappiservices.com/api/Reseller/ServicesList"

JSON 响应示例

[
  {
    "rate": 0.0152,
    "service": 199825,
    "category": "Steam",
    "name": "Steam Like SharedFiles/Screenshots/Guides/Workshop",
    "desc": "link: a steamcommunity.com/sharedfiles/filedetails/?id=... URL ...",
    "type": "Default",
    "min": 1,
    "max": 1100,
    "active": true,
    "optionalParams": []
  },
  {
    "rate": 0.0264,
    "service": 199835,
    "category": "Steam",
    "name": "Steam Profile Comments (your own comments)",
    "desc": "link: the profile SteamID64 ... Send \"comments\", \"comments_json\" or package=lib:<id> ...",
    "type": "Custom Comments",
    "min": 1,
    "max": 10000,
    "active": true,
    "optionalParams": ["delay", "comments_json", "package", "allow_partial"]
  }
]

响应参数

参数类型说明
serviceinteger服务的 ID。
ratedecimal单价,所有价格均以 USD 计。
categorystring服务所属的分类。
namestring服务名称。
descstring服务说明或使用方法。
typestringDefault(link + quantity;评论服务还需要 package)或 Custom Comments(还需要 comments、comments_json 或 package=lib:)。
mininteger该服务允许的最小数量。
maxinteger该服务允许的最大数量。
activeboolean服务被关闭或缺货时为 false:RegisterOrder 会拒绝该服务。
optionalParamsstring[]该服务接受的 RegisterOrder 可选参数。

GET /Balance

获取持有该 API 密钥的账户当前的钱包余额。

请求参数

参数类型说明
keystring用于身份验证的 API 密钥。

请求示例

curl -H "X-Api-Key: YOUR_API_KEY" "https://cappiservices.com/api/Reseller/Balance"

JSON 响应示例

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

POST /RegisterOrder

创建订单并立即从您的钱包扣款(quantity × rate)。扣款前会先验证 link;当服务不可用、数量超出范围、link 与服务不匹配或余额不足时,订单将被拒绝且不会扣款。

请求参数

参数类型说明
keystring用于身份验证的 API 密钥。
serviceIdinteger服务的 ID。
linkstring订单的目标:URL、SteamID64 或交易链接,取决于具体服务(见服务表)。
quantityinteger要交付的数量,介于该服务的最小值和最大值之间。
commentsstring仅限自定义评论服务:您的评论,每行一条。
comments_jsonstring仅限自定义评论服务,且仅限表单正文:字符串组成的 JSON 数组,每项一条评论(允许换行)。用来代替 comments。
packagestring仅限评论服务。在预设评论服务中为必填;多个值用逗号分隔。 接受 cat:<category>[:<language>] 和 lib:<id>(每个订单最多 10 个 lib:<id>)。在自定义评论服务中:你自己的私有包的 lib:<id>。
delaystring仅限自定义评论服务:评论之间的间隔;每条评论的价格取决于该间隔。可选,默认 10 Seconds。
allow_partialstring仅限自定义评论服务:1 = 部分评论未通过时,仅用已通过的评论继续(价格不变)。可选。

请求示例

curl -X POST -H "X-Api-Key: YOUR_API_KEY" \
  -d "serviceId=199825" \
  -d "link=https://steamcommunity.com/sharedfiles/filedetails/?id=123456789" \
  -d "quantity=100" \
  "https://cappiservices.com/api/Reseller/RegisterOrder"

# custom comments (199835): one comment per line, URL-encoded line breaks (%0A) in the form body
curl -X POST -H "X-Api-Key: YOUR_API_KEY" \
  --data-urlencode "serviceId=199835" \
  --data-urlencode "link=76561198307708414" \
  --data-urlencode "quantity=20" \
  --data-urlencode "delay=7 Minutes" \
  --data-urlencode $'comments=Nice profile!\nGreat games.\n+rep' \
  "https://cappiservices.com/api/Reseller/RegisterOrder"

# comments_json (199835-199837, form body only): one comment per item, line breaks kept
curl -X POST -H "X-Api-Key: YOUR_API_KEY" \
  --data-urlencode "serviceId=199835" \
  --data-urlencode "link=76561198307708414" \
  --data-urlencode "quantity=20" \
  --data-urlencode 'comments_json=["Nice profile!","GG WP\nsee you next match"]' \
  "https://cappiservices.com/api/Reseller/RegisterOrder"

# library (199832-199834, package required): categories and/or packages, comma separated
curl -X POST -H "X-Api-Key: YOUR_API_KEY" \
  --data-urlencode "serviceId=199832" \
  --data-urlencode "link=76561198307708414" \
  --data-urlencode "quantity=20" \
  --data-urlencode "package=cat:praise:en,cat:emoji,lib:12" \
  "https://cappiservices.com/api/Reseller/RegisterOrder"

JSON 响应示例

{ "success": true, "error": null, "insufficientFunds": false, "orderId": 12345, "charge": 1.52 }

{ "success": false, "error": "Insufficient Funds!!", "insufficientFunds": true, "orderId": 0, "charge": 1.52 }

{ "success": false, "error": "Some comments were not approved (see rejectedIndexes). ...", "insufficientFunds": false, "orderId": 0, "charge": 0,
  "acceptedComments": 2, "rejectedComments": 1, "reviewComments": 0, "unverifiedComments": 0, "truncatedComments": 0,
  "rejectedIndexes": [2], "rejectedReasons": ["link"] }

响应参数

参数类型说明
successboolean表示订单是否提交成功。
orderIdinteger已提交订单的 ID。
chargedecimal已扣除的金额(USD):quantity × rate。
insufficientFundsboolean表示订单是否因余额不足而未被处理。
errorstring订单提交失败时的错误信息。
acceptedComments
rejectedComments
reviewComments
unverifiedComments
truncatedComments
integer仅限自定义评论订单:你的列表中有多少条评论被通过、被拒绝、进入人工审核、未审核(请稍后重试),以及因按 quantity 截取而被略去。
rejectedIndexes
rejectedReasons
integer[]
string[]
仅限自定义评论订单:被拒绝的评论在你列表中的位置(从 0 开始)以及每条的原因(format、link、contact 或 policy)。

GET /OrderStatus

查询您某个订单的状态和交付数量。

请求参数

参数类型说明
keystring用于身份验证的 API 密钥。
orderIdinteger订单编号。

请求示例

curl -H "X-Api-Key: YOUR_API_KEY" "https://cappiservices.com/api/Reseller/OrderStatus?orderId=12345"

JSON 响应示例

{
  "status": "Complete",
  "charge": 1.52,
  "walletReturn": 0.0304,
  "mode": "Like_SharedFile",
  "sucess": 98,
  "success": 98,
  "failed": 2,
  "quantity": 100,
  "remains": 2,
  "observation": "Info - Your order was finalized due to a lack of accounts in the database...",
  "currency": "USD",
  "date": "2026-11-01T14:03:27.1234567Z"
}

响应参数

参数类型说明
statusstring订单状态:EnviarParaBackEnd(已付款,等待派发)、NaFila(排队中)、Processing(交付中)或 Complete(已结束:全部交付、部分交付、失败或已取消)。
chargedecimal创建订单时从您的钱包扣除的金额(USD)。
walletReturndecimal未能交付的部分退回您钱包的金额(USD)。在订单变为 Complete 之前为 0。
modestring内部服务名称(MODE)。
successinteger已交付的数量。
sucessinteger与 success 的值相同。为保持兼容而保留(旧拼写)。
failedinteger未交付的数量(仅当 status 为 Complete 时才是最终值)。
quantityinteger下单数量。
remainsinteger仍待交付的数量。
observationstring关于结果的说明(链接无效、账号不足、已取消等)。全部交付时为空。
currencystring费用的货币单位。
datestring创建日期和时间(UTC)。

订单生命周期与退款

订单创建时即从钱包扣款。订单依次经历 EnviarParaBackEnd、NaFila、Processing 和 Complete。Complete 是唯一的最终状态:请对比 quantity、success 和 failed,以判断订单是全部交付还是部分交付。订单完成时,未能交付的部分会自动退回钱包(walletReturn),observation 会说明原因。订单无法通过 API 取消;订单处于 Processing 状态时,请使用客户面板操作。

错误信息

所有错误均使用 HTTP 400 和 error 字段。最常见的有:

{ "error": "Invalid ApiKey." }
error说明
Invalid parameters缺少或无效的 key、serviceId、link 或 quantity。
Invalid ApiKey.该密钥不属于任何账户(请检查旧密钥的 URL 编码)。
Your account has been disabled, please contact support.
Before accessing the panel you need to confirm your email.
账户已被停用,或电子邮件尚未确认。
Service:{id} Not Found未知的 serviceId。
Service temporarily unavailable.服务当前已关闭或缺货(见 ServicesList 中的 active)。
Quantity must be between 1 and {max}.数量超出该服务的最小/最大范围。
Invalid URL Link
Invalid Parameters: Only the user's SteamID64 must be entered, not a URL
link 与该服务要求的格式不匹配。
Insufficient Funds!!钱包余额低于 quantity × rate。未扣款。
Unknown comments package "..."
Unknown comments category "..."
Some comments were not approved ...
Comment review limit reached, try again later
评论:未知的包或类别、选择数量太少、评论未通过或审核暂时不可用。不会扣款。
Order not found.
Access denied.
该订单不存在,或属于其他账户。
Too many requests... (HTTP 429)每个 IP 地址每 1 分钟最多 120 次请求。超出限制时,API 将返回 HTTP 429 并附带 Retry-After 响应头。