🔑
应用与 API 密钥
创建应用后系统自动生成专属 API 密钥,程序通过 X-API-Key 鉴权。怀疑泄露时可一键重置,旧密钥立即失效。
注册一个应用即可获得专属 API 密钥,用统一积分调用平台开放能力。接口按次计费、支持幂等扣费,余额实时查询——把复杂的能力接入,简化成一次 HTTP 请求。
用户与开发者使用同一套账户体系,积分既能充值,也直接作为接口调用的计费单位。
创建应用后系统自动生成专属 API 密钥,程序通过 X-API-Key 鉴权。怀疑泄露时可一键重置,旧密钥立即失效。
全平台只有积分一种钱包,余额实时可查。充值到账后即可用于调用,无需在多套额度之间切换。
每次调用按积分原子扣减,同一个 request_id 重复请求不会重复扣费;积分不足时返回 code 402,便于程序兜底。
下面两个接口当前已上线,使用应用的 API 密钥即可在你的程序中调用。
# 查询积分余额 curl -X GET "https://trade.pianam.cn/api/v1/open/quota" \ -H "X-API-Key: 你的应用密钥"
# 扣减积分;同一 request_id 重复请求不会重复扣费 curl -X POST "https://trade.pianam.cn/api/v1/open/quota/consume" \ -H "X-API-Key: 你的应用密钥" \ -H "Content-Type: application/json" \ -d '{"amount": 1, "request_id": "唯一请求ID"}'
从注册到发出第一次请求,全部在开发者控制台完成。
在控制台注册账号,创建一个应用,系统会自动生成该应用专属的 API 密钥。
在「购买积分」中选择积分包,或使用兑换码充值,积分实时进入账户余额。
在程序请求头携带 X-API-Key 调用开放接口,也可以先用控制台「接口测试」在线验证。
没有复杂套餐,调用多少算多少。
1 元 = 100 积分,1 积分 = 1 次接口调用(0.01 元/次)。
积分仅用于平台内调用消耗,不可提现、不可在用户之间转让,详见控制台说明。