获取题库
收藏获取 access_token
该接口用于获取开放能力接口的调用凭证 access_token。
access_token 有效期为 2 小时，需要定期刷新。
获取题库
用于小玩法获取题库。使用前开发者需联系运营人员申请“弹幕题库能力”，待审批通过后即可使用此接口。
频率限制：单个 app_id 调用上限为 10 次/秒。
请求地址
GET https://webcast.bytedance.com/api/quiz/get
请求参数
- •请求Headers
字段 | 数据类型 | 必填 | 说明 |
X-Token | string | 是 | 通过接口获取的access_token |
- •请求Query参数
字段 | 数据类型 | 必填 | 说明 |
level | int | 否 | 难度，范围支持从1 ~ 6，不填默认为0表示随机难度 |
num | int | 否 | 返回的题目数量，最大100，不填默认为100 |
type | int | 否 | 题目类型，1：选择题， 2：判断题， 不填 默认为1即选择题 |
返回值
字段 | 数据类型 | 说明 |
errcode | int | 请求错误码，0表示成功，非0表示失败 |
errmsg | string | 非0错误码时，携带额外的错误提示信息 |
data | object | 请求成功时的返回的结构体 |
-list | array | 题目数组 |
--title | string | 题目的标题 |
--options | array | 题目的选项 |
--answer | int | 题目的答案下标，即options的下标，选择题范围1~4，判断题范围1~2 |
--id | string | 题目ID，全局唯一，可用于去重 |
返回数据示例
- •请求
curl --location --request GET 'https://webcast.bytedance.com/api/quiz/get?level=1&num=2&type=1' \ --header 'x-token: 123456'
- •正常返回
{ "data": { "list": [ { "title": "题目1", "options": [ "选项1", "选项2", "选项3", "选项4" ], "answer": 1, "id": "EYDnokrgyVeOeFa" }, { "title": "题目2", "options": [ "选项1", "选项2", "选项3", "选项4" ], "answer": 4, "id": "TlL6LwvWapkoBMv" } ] } }
- •错误返回
{ "errcode": 40001, "errmsg": "invalid params" }
- •错误码说明
错误码 | 错误信息 | 描述 |
-1 | system error | 服务内部异常 |
40001 | request params are invalid | 参数有误 |
40002 | you don't have permission | 通常为小玩法没有该项能力 |
40007 | over frequency control | 调用频率过高 |
