卡世界平台API开放对接文档

本文为卡世界平台官方提供的技术对接指南，内容涉及平台API调用方法，供开发者参考，平台合作方可根据自身需求选择是否对接，具体收益以实际运营结果为准。

我们开放的接口覆盖了从「选品」到「结算」的完整链路，不需要再手动后台点来点去，全部可以用代码自动跑。

图：7个核心接口的完整业务链路。核心接口一共有七个：在售商品列表（GET）用于拉取当前所有在售商品，查询商品（GET）用于查某个商品的详细信息、套餐内容、佣金，查询商品的可选地区（GET）用于看这个商品哪些城市能发货，选号接口（POST）用于给下单用户选手机号，查询订单（POST）用于查订单状态、物流、激活情况，结算状态批量查询（POST）用于批量查一批订单的佣金结算状态，可结算订单列表（POST）用于拉取能提现的订单清单，整个链路就是拉商品→展示给用户→查地区→选号码→提交订单→查状态→查佣金。第一步拿商品数据，在售商品列表接口调一下就能拿到所有在售商品的基础信息：名称、月租、流量、头图、你的推广链接，建议每天定时拉一次做缓存，商品上下架会变但没那么频繁，Python示例代码如下：

python
import requests
url = “https://ym.ksjhaoka.com/api/index/goods/index”
params = {
“store_id”: “你的店铺ID”,
“keyword”: “”,
“current”: “1”,
“size”: “20”
}
resp = requests.get(url, params=params)
data = resp.json()
for goods in data[“data”][“list”]:
print(f”商品名：{goods[‘name’]}，月租：{goods[‘tabs’]}”)
bash
curl -X GET “https://ym.ksjhaoka.com/api/index/goods/index?store_id=你的店铺ID&current=1&size=20”

图：通过代码直接调用API获取数据。用户点进某个商品时调查询商品详情接口，返回完整的套餐规则、优惠期、合约期、首充要求、禁发地区、佣金金额，参数是id（商品ID）加store_id（你的店铺ID，必传，用来算你的佣金）：

python
import requests
url = “https://ym.ksjhaoka.com/api/index/goods/show”
params = {
“id”: “42342450”,
“store_id”: “你的店铺ID”
}
resp = requests.get(url, params=params)
data = resp.json()
print(data)
bash
curl -X GET “https://ym.ksjhaoka.com/api/index/goods/show?id=42342450&store_id=你的店铺ID”
建议用户点进商品详情时再调，不要一口气全拉，数据量太大。查询可选地区接口传入商品ID，返回省-市-区三级树，每个节点标了disable字段，false表示能发，true表示不能发：

python
import requests
url = “https://ym.ksjhaoka.com/api/index/region”
params = {“goods_id”: “82341958”}
resp = requests.get(url, params=params)
data = resp.json()
for province in data[“data”][“data”]:
print(f”省份：{province[‘name’]}”)
for city in province.get(“children”, []):
status = “可发” if not city.get(“disable”) else “禁发”
print(f” {city[‘name’]} – {status}”)
bash
curl -X GET “https://ym.ksjhaoka.com/api/index/region?goods_id=82341958”

图：不同商品的可发货地区不同，请通过接口实时获取。前端展示建议地区选择器直接用这个数据渲染，禁发的置灰，用户点不了。第二步下单流程，如果商品支持选号，用选号接口拉可选号码池，返回手机号列表展示给用户挑，注意不是所有商品都支持选号，先查商品详情里的配置：

python
import requests
url = “https://ym.ksjhaoka.com/api/index/pool”
payload = {
“goods_id”: 82341946,
“attribution_province”: 3163,
“attribution_city”: 3268,
“keyword”: “”,
“searchCondition”: False,
“set_meal”: “”,
“pool_code”: “”,
“token”: “”,
“number_segment”: “all”
}
resp = requests.post(url, json=payload)
data = resp.json()
print(data)
bash
curl -X POST https://ym.ksjhaoka.com/api/index/pool -H “Content-Type: application/json” -d ‘{“goods_id”:82341946,”attribution_province”:3163,”attribution_city”:3268,”keyword”:””,”searchCondition”:false,”set_meal”:””,”pool_code”:””,”token”:””,”number_segment”:”all”}’
第三步查订单追佣金，查询订单接口按手机号或订单号查订单状态，返回字段包括订单状态、物流信息、首充金额、失败原因：

python
import requests
url = “https://ksjhaoka.com/api/index/ktt/query/order”
payload = {
“store_id”: “你的店铺ID”,
“order_no”: “order20260623161816995528”,
“api_key”: “你的API密钥”
}
resp = requests.post(url, data=payload)
data = resp.json()
for order in data[“data”]:
print(f”订单：{order[‘order_no’]}，状态：{order[‘statuss’]}，佣金：{order[‘brokerage’]}”)
bash
curl -X POST https://ksjhaoka.com/api/index/ktt/query/order -d “store_id=你的店铺ID” -d “order_no=order20260623161816995528” -d “api_key=你的API密钥”
建议跑一个定时任务每天查一遍新订单的状态变化同步到你自己的系统。结算状态批量查询一次查最多几百条订单的结算状态，返回每个订单的结算金额、结算状态、不结算原因：

python
import requests
url = “https://ym.ksjhaoka.com/api/index/brokerage/settle_query”
payload = {
“store_id”: “你的店铺ID”,
“api_key”: “你的API密钥”,
“order_nos”: [“order20260623161446995528”, “order20260623161816995528”]
}
resp = requests.post(url, json=payload)
data = resp.json()
for item in data[“data”]:
print(f”订单：{item[‘order_no’]}，结算状态：{item[‘brokerage_status_text’]}，佣金：{item[‘brokerage’]}”)
bash
curl -X POST https://ym.ksjhaoka.com/api/index/brokerage/settle_query -H “Content-Type: application/json” -d ‘{“store_id”:”你的店铺ID”,”api_key”:”你的API密钥”,”order_nos”:[“order20260623161446995528”]}’
常见不结算原因有用户未首充、激活后秒注销、套餐变更、违规推广等。可结算订单列表直接拉取所有能提现的订单，用来做佣金提现页面，支持按状态筛选，返回订单明细和汇总金额：

python
import requests
url = “https://ym.ksjhaoka.com/api/index/brokerage/settle_list”
payload = {
“store_id”: “你的店铺ID”,
“api_key”: “你的API密钥”,
“current”: “1”,
“size”: “20”,
“status”: “0”
}
resp = requests.post(url, data=payload)
data = resp.json()
print(f”总共有 {data[‘data’][‘pagination’][‘total’]} 条可结算订单”)
for order in data[“data”][“list”]:
print(f”订单：{order[‘order_no’]}，佣金：{order[‘brokerage’]}，状态：{order[‘brokerage_status_text’]}”)
bash
curl -X POST https://ym.ksjhaoka.com/api/index/brokerage/settle_list -d “store_id=你的店铺ID” -d “api_key=你的API密钥” -d “current=1” -d “size=20” -d “status=0”
所有接口统一用api_key认证，登录卡世界后台个人中心复制你的密钥，每次请求带上api_key参数，注意api_key别写死在代码里也别放前端，放服务端环境变量：

python
import os
API_KEY = os.environ.get(“KASHIJIE_API_KEY”)
STORE_ID = os.environ.get(“KASHIJIE_STORE_ID”)
常见问题方面，接口有频率限制吗？目前单接口QPS限制10，正常业务完全够用，如果超了会返回429稍后重试即可。地区数据会更新吗？会，运营商政策调整可能导致某些地区突然停发，建议每天同步一次地区数据。订单状态多久变一次？发货一般1-3个工作日，激活是用户收到货后自主激活，首充激活后当天或次日，结算首充后次月出账。测试环境有吗？有，上面每个接口都可以先把域名换成Mock地址调通再切正式环境，Mock地址在文档页面里复制。为什么有些接口域名是ym.ksjhaoka.com有些是ksjhaoka.com？历史原因两个域名都指向同一套服务，建议统一用ym.ksjhaoka.com，只有查询订单接口必须用ksjhaoka.com。完整对接步骤是申请API密钥（后台个人中心），每天定时跑在售商品列表缓存到本地数据库，用户浏览商品从缓存读取商品列表，用户点进商品详情调查询商品详情和查地区接口（展示套餐规则和用户选地址时校验是否可发），如果商品支持选号就调选号接口展示号码池，用户提交订单跳卡世界主站完成下单，每天定时跑查询订单同步状态到自己的系统，次月跑可结算订单列表批量查结算状态申请提现。文档地址、密钥申请、技术支持全部在卡世界后台API中心，有问题直接在代理群@技术客服。做号卡业务信息同步效率决定你能赚多少，手动后台查订单算佣金一天撑死处理几十单，接口对接之后系统自动跑你只需要看数据大屏，已经有不少代理商用这套接口搭了自己的分销系统月单量过万的不在少数，技术门槛不高一个后端加一个前端一周就能跑起来。本文档由卡世界技术团队整理发布，接口持续迭代中建议收藏本文档链接随时回来看最新版本。

Kimi Agent。免责声明：本文为广告推广，旨在介绍平台能力，不构成任何收益承诺，实际业务成果取决于运营方式、市场环境等多方因素，平台保留对接口、参数及规则的最终解释权，所有数据以实际运营为准，合作方应自行评估业务风险合理使用接口，平台不对因使用接口产生的直接或间接损失承担责任。