English
Log In
You can then view all documents
成长工具/内容输出/内容SDK/服务端接口/短剧信息接口
短剧信息接口
Last updated 2024-10-26 19:58:26

一、接口说明

  1. 建议使用短剧物料做页面渲染时(聚合页或者入口渲染等),采用实时获取的方式;
  2. 在接入前,请参考文档最后一部分获取密钥server key

请求说明

  • 请求域名:https://csj-sp.csjdeveloper.com
  • 请求方式:POST
  • 数据格式:json
  • 公共请求头:

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进制。

复制

示例代码

golang

复制

PHP

复制

Python

复制

Java

复制

1、获取类目列表

path

/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

二级类目列表

返回示例

复制

2、获取短剧信息

path

/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

是否潜力短剧

返回示例

复制

二、获取server key


Contents
Contact us