请求地址
https://api.chario.cn/api/v1/hitokoto
请求方式
GET
返回格式
JSON{
"id": 1,
"hitokoto": "愿你出走半生，归来仍是少年",
"from": "网络"
}
请求示例
https://api.chario.cn/api/v1/hitokoto?token=YOUR_TOKEN
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token |
string | 是 | 用户 API Token |
c |
string | 否 | 分类，如 a=动画 b=漫画 |
返回参数
暂无返回参数说明
状态码格式说明
| 状态码 | 说明 |
|---|---|
200 |
请求成功 |
400 |
请求参数错误 |
401 |
未授权或 Token 无效 |
403 |
禁止访问 |
404 |
接口不存在 |
429 |
请求过于频繁 |
500 |
服务器内部错误 |
503 |
接口维护中 |
系统级错误
| 错误码 | 说明 |
|---|---|
400 | 请求参数错误或格式不正确 |
401 | 未提供 Token 或 Token 无效 / 已过期 |
403 | 无权限访问该接口，或账号被禁用 |
404 | 接口不存在或路径错误 |
405 | 请求方法不允许 |
429 | 请求频率超限，请稍后重试 |
500 | 服务器内部错误，请联系管理员 |
503 | 接口维护中，暂时不可用 |
业务级错误请以接口返回体中的 code / msg 字段为准。
PHP
$url = 'https://api.chario.cn/api/v1/hitokoto' . '?token=YOUR_TOKEN&c=value'; $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response;
C++
// 需链接 libcurl
#include <curl/curl.h>
#include <string>
#include <iostream>
static size_t write_cb(char* ptr, size_t size, size_t nmemb, void* userdata) {
auto* out = static_cast<std::string*>(userdata);
out->append(ptr, size * nmemb);
return size * nmemb;
}
int main() {
CURL* curl = curl_easy_init();
if (!curl) return 1;
std::string response;
std::string url = "https://api.chario.cn/api/v1/hitokoto?token=YOUR_TOKEN&c=value";
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_cb);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
CURLcode res = curl_easy_perform(curl);
if (res == CURLE_OK) std::cout << response << std::endl;
curl_easy_cleanup(curl);
return 0;
}
Go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
resp, err := http.Get("https://api.chario.cn/api/v1/hitokoto?token=YOUR_TOKEN&c=value")
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
在线测试
响应结果
等待请求…