API文档 - 智能题库API平台

概述

智能题库API提供标准化题目查询与答案返回接口，支持开发者快速集成搜题解题功能。接口支持GET/POST（表单/JSON）多种请求方式，返回JSON格式数据。

基础信息

接口地址：https://bbtiku.bbai.xyz/api/tiku_api.php
API版本：v1
请求方式：GET / POST（表单/JSON）
数据格式：JSON
编码格式：UTF-8

接口鉴权

接口仅通过 api_key 进行鉴权，无需签名、时间戳，api_key 可通过URL参数/POST表单/JSON请求体传入，优先读取POST参数。

鉴权参数

参数名	是否必填	传递方式	说明
api_key	是	URL参数 / POST表单 / JSON请求体	平台分配的调用密钥

题目查询接口

接口地址：https://bbtiku.bbai.xyz/api/tiku_api.php

请求方式：GET / POST（表单/JSON）

参数优先级：JSON请求体 > POST表单 > URL参数

请求参数

参数名	类型	是否必填	传递方式	说明
api_key	string	是	URL参数 / POST表单 / JSON请求体	平台分配的密钥
q	string	是	URL参数 / POST表单 / JSON请求体	题目内容/题目关键词（支持特殊字符如+、=等）
info	string	否	URL参数 / POST表单 / JSON请求体	附加信息（如调用来源、备注等）

请求示例

1. GET请求（URL参数）

https://bbtiku.bbai.xyz/api/tiku_api.php?api_key=tk_c8FZHS01ug3xXJM6soT27lAyYdVCIBOU&q=1+1=?

2. POST请求（表单格式）

POST https://bbtiku.bbai.xyz/api/tiku_api.php
Content-Type: application/x-www-form-urlencoded

api_key=tk_c8FZHS01ug3xXJM6soT27lAyYdVCIBOU&q=1+1=?&info=form_request

3. POST请求（JSON格式）

POST https://bbtiku.bbai.xyz/api/tiku_api.php
Content-Type: application/json

{
  "api_key": "tk_c8FZHS01ug3xXJM6soT27lAyYdVCIBOU",
  "q": "1+1=?",
  "info": "json_request"
}

4. 混合传参（api_key在URL，q在POST）

POST https://bbtiku.bbai.xyz/api/tiku_api.php?api_key=tk_c8FZHS01ug3xXJM6soT27lAyYdVCIBOU
Content-Type: application/json

{
  "q": "1+1=?",
  "info": "mixed_request"
}

正常返回格式

{
  "code": 200,
  "msg": "获取答案成功",
  "data": "2",
  "remain_token": 99
}

无答案返回格式

{
  "code": -1,
  "msg": "无答案，已自动收录",
  "data": "",
  "remain_token": 99
}

字段说明

字段	类型	说明
code	int	200=成功，-1=无答案，401=鉴权失败，400=参数错误，500=服务器错误
msg	string	返回信息描述
data	string	答案内容（格式：答案###解析，无答案时为空）
remain_token	int	剩余调用次数（仅获取到答案时扣减）

错误码说明

错误码	说明	解决方案
200	获取答案成功	正常使用返回结果
-1	无答案，已自动收录	题目将AI补充，可稍后重试
400	参数错误（缺少 api_key 或 q）	检查是否传入必填参数，确保参数格式正确
401	api_key 不存在或无效	核对api_key是否正确，联系平台获取有效密钥
402	次数不足（余额不足）	联系平台充值调用次数
500	服务器内部错误	请稍后重试，或联系平台技术支持

调用示例

Python 示例（支持GET/POST）

import requests

API_KEY = "tk_c8FZHS01ug3xXJM6soT27lAyYdVCIBOU"
URL = "https://bbtiku.bbai.xyz/api/tiku_api.php"

# 1. GET请求示例
def get_answer_get(question):
    params = {
        "api_key": API_KEY,
        "q": question,
        "info": "python_get_request"
    }
    resp = requests.get(URL, params=params)
    result = resp.json()
    print("GET请求结果：", result)

# 2. POST表单请求示例
def get_answer_post_form(question):
    data = {
        "api_key": API_KEY,
        "q": question,
        "info": "python_post_form_request"
    }
    resp = requests.post(URL, data=data)
    result = resp.json()
    print("POST表单请求结果：", result)

# 3. POST JSON请求示例
def get_answer_post_json(question):
    data = {
        "api_key": API_KEY,
        "q": question,
        "info": "python_post_json_request"
    }
    headers = {"Content-Type": "application/json"}
    resp = requests.post(URL, json=data, headers=headers)
    result = resp.json()
    print("POST JSON请求结果：", result)

# 使用示例
if __name__ == "__main__":
    question = "1+1=?"
    get_answer_get(question)
    get_answer_post_form(question)
    get_answer_post_json(question)

PHP 示例（支持GET/POST）

 $api_key,
    "q" => $q,
    "info" => "php_post_form_request"
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://bbtiku.bbai.xyz/api/tiku_api.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post_form_data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response_post_form = curl_exec($ch);
curl_close($ch);
echo "POST表单请求结果：" . $response_post_form . "\n";

// 3. POST JSON请求示例
$post_json_data = json_encode([
    "api_key" => $api_key,
    "q" => $q,
    "info" => "php_post_json_request"
]);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://bbtiku.bbai.xyz/api/tiku_api.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_json_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response_post_json = curl_exec($ch);
curl_close($ch);
echo "POST JSON请求结果：" . $response_post_json . "\n";
?>

JavaScript/Node.js 示例

// Node.js环境（需安装axios：npm install axios）
const axios = require('axios');

const API_KEY = "tk_c8FZHS01ug3xXJM6soT27lAyYdVCIBOU";
const URL = "https://bbtiku.bbai.xyz/api/tiku_api.php";
const question = "1+1=?";

// 1. GET请求
axios.get(URL, {
    params: {
        api_key: API_KEY,
        q: question,
        info: "js_get_request"
    }
}).then(response => {
    console.log("GET请求结果：", response.data);
}).catch(error => {
    console.error("GET请求错误：", error);
});

// 2. POST表单请求
axios.post(URL, new URLSearchParams({
    api_key: API_KEY,
    q: question,
    info: "js_post_form_request"
})).then(response => {
    console.log("POST表单请求结果：", response.data);
}).catch(error => {
    console.error("POST表单请求错误：", error);
});

// 3. POST JSON请求
axios.post(URL, {
    api_key: API_KEY,
    q: question,
    info: "js_post_json_request"
}, {
    headers: {
        'Content-Type': 'application/json'
    }
}).then(response => {
    console.log("POST JSON请求结果：", response.data);
}).catch(error => {
    console.error("POST JSON请求错误：", error);
});

文档导航

概述