天气预报 - API文档

接口信息

API ID: 14

总调用: 198

添加时间: 2025-07-29

更新时间: 2026-10-13

访问权限: 公开访问（无需密钥）

请求信息

请求地址

https://xinnai.asia/API/weather.php

示例地址

https://xinnai.asia/API/weather.php?city=北京

鉴权方式（API Key）

所有接口需在请求中携带你的 API Key。我们支持两种方式，推荐优先使用 Bearer 请求头（避免密钥出现在 URL 日志中）。

方式一：Bearer 请求头（推荐）

Authorization: Bearer 你的API_KEY

方式二：URL 参数（兼容旧版）

?apikey=你的API_KEY

你可在「用户中心 → API 管理」中查看主密钥、创建子密钥（多密钥 / 轮换），或吊销已泄露的密钥。

速率限制（QPS）

本接口单账号限速：未单独限制（默认全局限流） 次/秒。超出限制将返回 429，请合理控制并发并在客户端做退避重试。

API 错误码说明

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）。

请求参数

参数名	类型	必填	说明
city	string	是	查询城市
type	string	否	返回格式json/text
apikey	string	是	密钥

在线测试

此处将显示接口返回结果...

官方 SDK（快速接入）

下载对应语言的官方 SDK，已封装鉴权（Bearer / apikey）、自动重试与错误处理，几行代码即可接入。

PHP SDK Python SDK JavaScript SDK

调用示例

<?php
$url = 'https://xinnai.asia/API/weather.php';
$params = [
    'city' => 'YOUR_VALUE',
    'type' => 'YOUR_VALUE',
    'apikey' => '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/weather.php"
params = {
    'city': 'YOUR_VALUE',
    'type': 'YOUR_VALUE',
    'apikey': 'YOUR_VALUE',}
response = requests.get(url, params=params)
print(response.text)

const url = new URL('https://xinnai.asia/API/weather.php');
const params = {
    'city': 'YOUR_VALUE',
    'type': 'YOUR_VALUE',
    'apikey': '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/weather.php';
const params = {
  'city': 'YOUR_VALUE',
  'type': 'YOUR_VALUE',
  'apikey': '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/weather.php"
    params := url.Values{}
    params.Add("city", "YOUR_VALUE")
    params.Add("type", "YOUR_VALUE")
    params.Add("apikey", "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/weather.php" + "?" +
            "city=YOUR_VALUE" + "&" +
            "type=YOUR_VALUE" + "&" +
            "apikey=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/weather.php" + "?" +
    string.Join("&",
        new (string, string)[] {
            ("city", "YOUR_VALUE"),
            ("type", "YOUR_VALUE"),
            ("apikey", "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/weather.php" "?"
        "city=YOUR_VALUE&"
        "type=YOUR_VALUE&"
        "apikey=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{
        {"city", "YOUR_VALUE"},
        {"type", "YOUR_VALUE"},
        {"apikey", "YOUR_VALUE"},    };
    auto res = cli.Get("/API/weather.php", params);
    if(res) std::cout << res->body << std::endl;
    return 0;
}

.版本 2
.子程序 _按钮_调用_被单击
.局部变量 网络操作对象, 网络操作类
.局部变量 返回文本, 文本型
.局部变量 完整网址, 文本型
完整网址 ＝ "https://xinnai.asia/API/weather.php" ＋ "?"
完整网址 ＝ 完整网址 ＋ "city" ＋ "=" ＋ "YOUR_VALUE"
完整网址 ＝ 完整网址 ＋ "type" ＋ "=" ＋ "YOUR_VALUE"
完整网址 ＝ 完整网址 ＋ "apikey" ＋ "=" ＋ "YOUR_VALUE"返回文本 ＝ 网络操作对象.网页_获取(完整网址)
调试输出(返回文本)