key | value | 备注 |
Content-Type | application/json | 请求json格式 |
x-csj-sp-site-id | 5xxxxxx | 在穿山甲平台申请的应用id,以5开头的7位数字 |
x-csj-sp-timestamp | 请求时间戳,比如:1699361433 | |
x-csj-sp-sign | 签名,见签名部分 | |
x-csj-sp-nonce | 16位随机字符串,必须16位 | |
x-csj-sp-version | 1.0 | 固定值1.0 |
使用HmacSHA256算法加密,秘钥获取方式参考本文d第二部分「获取server key」,拼接规则,最后转为16进制。
/csj_sp/openapi/v1/shortplay/get_category
http body格式为json
key | type | value |
uid | int | 用户在开发者侧唯一标志 |
请求示例
key | type | value |
ret | int | 0为成功,非0为失败,具体见msg |
msg | string | 非0错误码时,见该字段排查 |
request_id | string | 请求唯一标志,排查问题时可以拿此作为凭证 |
data | object |
data对象
key | type | value |
list | object | 类目数组 |
list对象
key | type | value |
id | int | 类目id |
name | string | 类目名称 |
level | int | 类目级别1:一级类目;2:二级类目; |
children | object | 二级类目列表 |
返回示例
/csj_sp/openapi/v1/shortplay/get_sp_list
http body格式为json
key | type | value |
uid | int | 用户在开发者侧唯一标志 |
page_size | int | 每页数量,默认为20 |
page | int | 请求页码,从1开始,默认为1 |
order | int | 请求顺序:0:正序;1:逆序 |
query_type | string | all:获取所有短剧 category:获取请求二级类目id短剧 shortplay:获取请求短剧id的短剧 |
shortplay_ids | []int | 短剧id列表,query_type为shortplay时必传,示例[1,2,3] |
category_id | []int | 短剧id列表,query_type为category时必传,示例[1,2,3] |
请求示例
key | type | value |
ret | int | 0为成功,非0为失败,具体见msg |
sub_ret | string | 二级错误码,当ret=0是,sub_ret为空 |
msg | string | 非0错误码时,见该字段排查 |
request_id | string | 请求唯一标志,排查问题时可以拿此作为凭证 |
data | object |
data对象
key | type | value |
list | object | 类目数组 |
total | int | 总共短剧数 |
has_more | bool | 是否还有短剧 |
list对象
key | type | value |
shortplay_id | int | 短剧id |
title | string | 短剧名称 |
desc | string | 短剧简介 |
cover_image | string | 短剧封面 |
category_id | int | 短剧二级类目id |
category_name | string | 短剧二级类目名称 |
total | int | 短剧的剧集数 |
create_time | int | 短剧创建时间 |
status | int | 完结状态. 0:已完结;1: 未完结 |
source_novel_name | string | 来源小说名称 |
source_novel_author | string | 来源小说作者 |
index | int | 历史观看集数 |
favorite_state | int | 收藏状态(1:收藏、2:取消收藏) |
favorite_time | int | 收藏时间 |
favorite_count | int | 收藏数量 |
icp_number | string | 备案号 |
level_label | int | 等级标签:"1:S级、2:A级、3:B级 |
is_potential | boolean | 是否潜力短剧 |
返回示例
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock