ksjhk/api has 326 GitHub stars and 0 forks. GitHot measured +33 stars in 24 hours. Last checked 2026-11-17 19:01 UTC. Last push 2026-11-09.
Measured star growth
- in 24h
- +33
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
卡世界开放平台 API 官方文档与调用示例(PHP / Python / Node.js / curl)—— 200+ 品牌卡券货源,公开查货、签名下单、自动发货
Developer ToolsREADME.md
Original卡世界开放平台 API
卡世界开放平台(kashijie.com)对外接口的官方文档与调用示例。
接入后你的系统可以直接调用 200+ 品牌会员权益卡券货源,也可以接入酒店实时预订与电影票在线选座出票。统一使用开放平台余额结算,履约失败自动退款。
- 会员权益、酒店、电影票只读查询免登录公开,不注册也能先看货、先比价
- 注册登录、创建密钥后,即可签名调用下单接口,余额扣费、随充随用
- 每个密钥可设加价倍数(1.00~99.99),你拿到的报价 = 底价 × 倍数,方便你转售时统一加价
本仓库面向调用方。如果你想自己部署一套这样的分销平台(自带收款、自带供货),看配套仓库 ksjhk/kaquan。
快速开始
1. 获取密钥 让用户提供本人未注册手机号,程序调用 /platform/quick-start 自动注册并生成首组密钥
2. 充值 控制台 → 余额充值(微信 / 支付宝扫码)
3. 查询 会员权益、酒店、电影只读接口可匿名调用
4. 下单 按下方签名规则拼 sign,调对应 order/create 接口
API 根地址:https://www.kashijie.com/open-api
接口一览
| 接口 | 方法 | 鉴权 | 说明 |
|---|---|---|---|
/v1/goods |
GET | 公开 | 货源列表(分类、分页) |
/v1/goods/detail |
GET | 公开 | 商品详情 |
/platform/quick-start |
POST | 公开 | 快速获取密钥:新手机号自动注册、生成首组密钥并自动登录 |
/v1/balance |
GET | 签名 | 余额查询 |
/v1/order/create |
POST | 签名 | 创建订单(余额扣费、自动发货、失败自动退款) |
/v1/order/query |
POST | 签名 | 订单查询(实时同步供货状态) |
/v1/hotel/search 等 |
GET / POST | 公开 | 酒店搜索、详情、房型报价、可订检查 |
/v1/hotel/order/create |
POST | 签名 | 创建酒店订单(余额扣费、酒店确认) |
/v1/hotel/order/query |
POST | 签名 | 查询酒店确认状态 |
/v1/movie/city 等 |
POST | 公开 | 城市、影片、影院、场次、座位查询 |
/v1/movie/order/create |
POST | 签名 | 锁座并创建电影票订单(余额扣费、自动出票) |
/v1/movie/order/query |
POST | 签名 | 查询出票状态与取票码 |
卡券与下单接口统一响应:{"code":0,"message":"...","data":{...}},code=0 为成功;酒店查询保留 success 字段,电影浏览查询成功时 code=200。金额单位一律为分。
完整字段说明:docs/api.md
签名规则(30 秒看懂)
1. 取全部请求参数,排除 sign 本身;query 与 body 混用时两处参数必须合并
2. 跳过空值、数组与对象
3. 按参数名升序拼接:k1=v1&k2=v2
4. 末尾追加 &secret=你的app_secret
5. sign = md5(拼接串),小写 32 位 hex
query、JSON body、表单三种方式均可;鉴权参数放 query、业务参数放 body 时,业务参数也必须参与签名。
每个签名请求必带:app_key、timestamp(秒级,与服务器偏差超 10 分钟拒绝)、sign。
示例代码
| 语言 | 文件 | 说明 |
|---|---|---|
| PHP | examples/php | 零依赖 Client 类 + 下单完整 demo |
| Python | examples/python | requests 版 Client + demo |
| Node.js | examples/nodejs | 原生 https 零依赖 + demo |
| curl | examples/curl | 命令行手工签名调试 |
每个 demo 都演示:查货源(公开)→ 查余额(签名)→ 下单 → 查订单 的完整链路。客户端同时提供 quickStart、hotelQuery / hotelOrderCreate / hotelOrderQuery 与 movieQuery / movieOrderCreate / movieOrderQuery 方法(Python 为下划线命名)。酒店、电影查询不签名,交易方法继续签名。
酒店/电影票完整参数见 docs/api.md 和 电影接口说明。
错误码
| code | 说明 |
|---|---|
| 0 | 成功 |
| 2 | 验证码错误或已过期 |
| 5 | 参数错误(含签名错误、限频) |
| 11 | app_key 无效或已禁用 |
| -9001 | 余额不足,请充值 |
完整错误码表见 docs/api.md。