获取题库

我的收藏

获取 access_token

该接口用于获取开放能力接口的调用凭证 access_token。

使用详情可参考: https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/server/interface-request-credential/get-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	调用频率过高