加载中...

基础信息

查看接口基本信息和返回格式
接口描述

获取台风信息

七日请求统计
本周总请求: - 日均: -
请求方式
GET POST 推荐
请求地址
https://api.cxzja.cn/api/tf
返回方式
JSON 默认返回格式,包含完整数据结构
返回预览
JSON
{
  "code": 200,
  "msg": "请求成功",
  "data": {
    "期号": "2026年总627期",
    "发布时间": "07月10日18时15分",
    "抓取时间": "2026-07-10 18:50:13",
    "耗时": "330ms",
    "中心位置": "北纬22.4度、东经126.4度",
    "纬度": 22.4,
    "经度": 126.4,
    "最大风力_raw": "13级, 40米/秒(约144公里/小时)",
    "风力": "13级",
    "风速": "40m/s",
    "风速_kmh": "144km/h",
    "中心气压_raw": "960 hPa",
    "气压": "960hPa",
    "参考位置": "距离浙闽交界东南方向约800公里",
    "风圈半径_raw": "七级风圈半径 东北方向500公里;东南方向500公里;西南方向480公里;西北方向500公里 十级风圈半径  东北方向350公里;东南方向320公里;西南方向280公里;西北方向300公里 十二级风圈半径 东北方向120公里;东南方向110公里;西南方向110公里;西北方向120公里",
    "七级风圈": "500km",
    "十级风圈": "350km",
    "十二级风圈": "120km",
    "预报结论": "“巴威”将以每小时20-25公里的速度向西北方向移动,强度还将有所加强(下次更新时间为10日19时15分)",
    "移动速度": "20-25km/h",
    "点位": "菲律宾海",
    "相对大陆": "距离浙闽交界东南方向约800公里"
  },
  "text_show": "🌀 活跃台风
风力:13级
风速:40m/s
气压:960hPa
坐标:北纬22.40° 东经126.40°
点位:菲律宾海
移动:20-25km/h
七级风圈:500km
十级风圈:350km
十二级风圈:120km
相对大陆:距离浙闽交界东南方向约800公里
动态预报:“巴威”将以每小时20-25公里的速度向西北方向移动,强度还将有所加强(下次更新时间为10日19时15分)
耗时:330ms",
  "api_source": "API官网:api.cxzja.cn",
  "timestamp": "2026-07-10 18:50:12"
}

计费标准

了解接口的计费方式和价格
免费接口
免费
完全免费
所有用户均可免费调用,无需付费
QPS限制
普通用户
不限
会员用户
不限
每日请求次数
普通用户
不限
会员用户
不限

安全认证

了解接口的认证方式和访问凭证管理
Token 认证

登录后可查看您的Token

立即登录
实名认证
无需实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
推荐 Header 认证

通过 HTTP Header 传递认证信息

Authorization
Bearer {access_token}

或通过curl请求参数传递:

curl
curl "https://api.cxzja.cn/api/tf?token=YOUR_TOKEN"

参数文档

查看接口请求参数和返回字段说明
请求参数
参数名 类型 必填 默认值 可选值 说明
token string 必填 登录后显示你的请求token 接口请求唯一认证标识!
mode string 可选 json json 返回格式

状态码

了解接口返回的状态码含义及处理方式
接口状态码
状态码 说明
200 请求成功
201 请求失败
服务器状态码

在线测试

在线调试接口,实时查看响应结果
发起请求
GET/POST

示例代码

多种语言的接口调用示例
PHP
JavaScript
NodeJs
Python
Go
Java
C#
C
C++
易语言
PHP
<?php
$API_TOKEN = 'YOUR_TOKEN';
$API_URL = 'https://api.cxzja.cn/api/tf';

$params = array(
    'token' => 'YOUR_TOKEN',
    'mode' => 'json',
);

$res = api::send($API_URL, $params, 'GET/POST');
print($res);

class api {
    public static function send($url, $data, $type) {
        $data = http_build_query($data);
        $ch = curl_init();
        if ($type == 'POST') {
            curl_setopt($ch, CURLOPT_URL, $url);
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        } else {
            curl_setopt($ch, CURLOPT_URL, $url . '?' . $data);
        }
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        $res = curl_exec($ch);
        curl_close($ch);
        return $res;
    }
}
JavaScript
$.ajax({
    url: 'https://api.cxzja.cn/api/tf',
    data: {
        token: 'YOUR_TOKEN',
        mode: 'json',
    },
    type: 'GET/POST',
    dataType: 'json',
    success: function(data) {
        console.log(data);
    },
    error: function(err) {
        console.log('请求失败', err);
    }
});
Python
import requests

url = "https://api.cxzja.cn/api/tf"
data = {
    "token": "YOUR_TOKEN",
    "mode": "json",
}

response = requests.post(url, data=data)
print(response.json())
Java
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;

public class ApiRequest {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://api.cxzja.cn/api/tf");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET/POST");
        conn.setConnectTimeout(10000);

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream()));
        String line;
        StringBuilder result = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            result.append(line);
        }
        reader.close();
        System.out.println(result.toString());
    }
}
Go
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
"strings"
)

func main() {
    data := "token=YOUR_TOKEN&mode=json"
    resp, _ := http.Post("https://api.cxzja.cn/api/tf",
        "application/x-www-form-urlencoded", strings.NewReader(data))
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
C#
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        var data = new FormUrlEncodedContent(new Dictionary<string, string> {
            {"token", "YOUR_TOKEN"},
            {"mode", "json"},
        });
        var response = await client.PostAsync("https://api.cxzja.cn/api/tf", data);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(response);
    }
}
NodeJs
const https = require('https');
const querystring = require('querystring');

const postData = querystring.stringify({
    'token': 'YOUR_TOKEN',
    'mode': 'json',
});
const options = {
    hostname: 'api.cxzja.cn',
    path: '/api/tf',
    method: 'POST',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
};
const req = https.request(options, res => {
    let data = '';
    res.on('data', d => data += d);
    res.on('end', () => console.log(data));
});
req.write(postData);
req.end();
C
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>

static size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {
    ((char*)userp)[0] = '\0';
    strcat(userp, contents);
    return size * nmemb;
}

int main() {
    CURL *curl;
    CURLcode res;
    char response[4096] = {0};

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.cxzja.cn/api/tf");
        curl_easy_setopt(curl, CURLOPT_POST, 1L);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, response);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);

        res = curl_easy_perform(curl);
        if(res == CURLE_OK) printf("%s\n", response);
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}
C++
#include <iostream>
#include <string>
#include <curl/curl.h>

size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
    userp->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    std::string response;

    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.cxzja.cn/api/tf");
        curl_easy_setopt(curl, CURLOPT_POST, 1L);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK) std::cout << response << std::endl;
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}
易语言
.版本 2
.支持库 spec

.局部变量 url, 文本型
.局部变量 params, 文本型
.局部变量 result, 文本型

url = "https://api.cxzja.cn/api/tf"
params = "token=YOUR_TOKEN&mode=json"

result = 编码_URL解码 (网页_访问 (url, , params))
调试输出 (result)

AI开发文档

导出接口文档供AI助手快速理解接口结构
复制下方内容粘贴给AI助手,即可快速生成对接代码。
JSON 格式 0 KB