IP签名档YT

> 声明：本文档由 AI 根据平台配置自动生成；示例为片段。 # IP签名档YT API 文档 ## 接口简介 IP签名档YT接口提供IP定位获取的城市天气及访问信息卡片服务。通过此接口，开发者可以轻松获取用户所在城市的天气信息，并生成美观的信息卡片。接口支持自定义标题和多种卡片类型，适用于网站、应用等场景的个性化展示。用户可通过传递IP地址获取特定位置的天气信息，也可不传IP自动获取请求者IP信息。 ## 请求说明 - **方法**: GET - **常用请求头**: Content-Type: application/json - **请求地址**: `https://api.xunjinlu.fun/apis/ytipcard` ## 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | key | string | 是 | 接口访问密钥（开启密钥访问时必填） | | title | string | 否 | 自定义文字(8个字以内) | | type | string | 否 | 卡片类型 | | ip | string | 否 | 请求者ip | ## 返回字段表 | 字段名 | 类型 | 说明 | |--------|------|------| | code | number | 状态码 | | msg | string | 提示信息 | | data | object | 返回数据 | ## 返回示例 ### 成功示例 ```json { "code": 200, "msg": "获取成功", "data": { "ip": "123.45.67.89", "country": "中国", "region": "广东省", "city": "深圳市", "isp": "电信", "weather": { "temp": "28°C", "weather": "晴", "humidity": "65%" }, "card_url": "https://example.com/card/123456" } } ``` ### 失败示例 ```json { "code": 400, "msg": "参数错误", "data": null } ``` ## 错误码 | 错误码 | 说明 | |--------|------| | 200 | 请求成功 | | 400 | 参数错误 | | 401 | 密钥无效 | | 403 | 访问受限 | | 500 | 服务器内部错误 | | 503 | 服务暂时不可用 | ## 调用示例 ### 浏览器直接访问 ``` https://api.xunjinlu.fun/apis/ytipcard?key=your_api_key&title=天气&ip=123.45.67.89 ``` ### cURL ```bash curl "https://api.xunjinlu.fun/apis/ytipcard?key=your_api_key&title=天气" ``` ### Python ```python import requests url = "https://api.xunjinlu.fun/apis/ytipcard" params = { "key": "your_api_key", "title": "天气" } response = requests.get(url, params=params) print(response.json()) ``` ### PHP ```php "your_api_key", "title" => "天气" ]; $context = stream_context_create([ "http" => [ "method" => "GET", "header" => "Content-Type: application/json\r\n", "ignore_errors" => true ] ]); $response = file_get_contents($url . "?" . http_build_query($params), false, $context); echo $response; ?> ``` ### HTML ```html ```