所有接口需在请求中携带你的 API Key。我们支持两种方式,推荐优先使用 Bearer 请求头(避免密钥出现在 URL 日志中)。
Authorization: Bearer 你的API_KEY
?apikey=你的API_KEY
你可在「用户中心 → API 管理」中查看主密钥、创建子密钥(多密钥 / 轮换),或吊销已泄露的密钥。
本接口单账号限速:未单独限制(默认全局限流) 次/秒。
超出限制将返回 429,请合理控制并发并在客户端做退避重试。
| HTTP 状态 | 业务 code | 含义 | 处理建议 |
|---|---|---|---|
| 200 | 0 / success | 成功 | — |
| 400 | 1 | 参数缺失或格式错误 | 检查请求参数 |
| 401 / 403 | 401 | API Key 无效或已吊销 | 核对密钥 / 重新生成 |
| 402 | 402 | 余额 / 点数不足 | 前往用户中心充值 |
| 429 | 429 | 请求过于频繁(限流) | 降低并发、稍后重试 |
| 500 | 500 | 服务端错误 | 稍后重试或提交工单 |
返回示例:{"code":0,"msg":"success","data":{...}}(失败时为非零 code 及 msg)。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | qq账号 |
下载对应语言的官方 SDK,已封装鉴权(Bearer / apikey)、自动重试与错误处理,几行代码即可接入。
<?php
$url = 'https://xinnai.asia/API/konata.php';
$params = [
'qq' => 'YOUR_VALUE',];
$url .= '?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
import requests
url = "https://xinnai.asia/API/konata.php"
params = {
'qq': 'YOUR_VALUE',}
response = requests.get(url, params=params)
print(response.text)
const url = new URL('https://xinnai.asia/API/konata.php');
const params = {
'qq': 'YOUR_VALUE',};
Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));
fetch(url)
.then(response => response.text())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
const axios = require('axios');
const url = 'https://xinnai.asia/API/konata.php';
const params = {
'qq': 'YOUR_VALUE',};
axios.get(url, { params })
.then(res => console.log(res.data))
.catch(err => console.error(err));
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL := "https://xinnai.asia/API/konata.php"
params := url.Values{}
params.Add("qq", "YOUR_VALUE") reqURL := baseURL + "?" + params.Encode()
resp, err := http.Get(reqURL)
if err != nil { panic(err) }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
String url = "https://xinnai.asia/API/konata.php" + "?" +
"qq=YOUR_VALUE" + "&" +;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
using System.Net;
var client = new HttpClient();
var url = "https://xinnai.asia/API/konata.php" + "?" +
string.Join("&",
new (string, string)[] {
("qq", "YOUR_VALUE"), }.Select(p => $"{WebUtility.UrlEncode(p.Item1)}={WebUtility.UrlEncode(p.Item2)}")
);
var response = await client.GetStringAsync(url);
Console.WriteLine(response);
#include
#include
#include
#include
int main(void) {
CURL *curl = curl_easy_init();
char *url = "https://xinnai.asia/API/konata.php" "?"
"qq=YOUR_VALUE&";
curl_easy_setopt(curl, CURLOPT_URL, url);
curl_easy_perform(curl);
curl_easy_cleanup(curl);
return 0;
}
#include
#include
int main() {
httplib::Client cli("https://xinnai.asia");
httplib::Params params{
{"qq", "YOUR_VALUE"}, };
auto res = cli.Get("/API/konata.php", params);
if(res) std::cout << res->body << std::endl;
return 0;
}
.版本 2
.子程序 _按钮_调用_被单击
.局部变量 网络操作对象, 网络操作类
.局部变量 返回文本, 文本型
.局部变量 完整网址, 文本型
完整网址 = "https://xinnai.asia/API/konata.php" + "?"
完整网址 = 完整网址 + "qq" + "=" + "YOUR_VALUE"返回文本 = 网络操作对象.网页_获取(完整网址)
调试输出(返回文本)