api接口案例

爱国 • 2025-04-06 01:09 • 帮助中心 • 阅读 14

获取用户信息接口，**URL**：/api/user/getUserInfo，**请求方式**：GET，**参数**：， userId（必填）：用户ID，用于指定要获取信息的用户。，**响应**：，成功时返回状态码200，数据格式为JSON，包含用户的姓名、年龄、性别等信息。，失败时返回相应错误状态码及错误信息。，，请求URL为/api/user/getUserInfo?userId=123，可能会得到如下响应：，“

json，{，    "code": 200,，    "data": {，        "name": "张三",，        "age": 25,，        "gender": "男"，    },，    "message": "获取成功"，}，

“

API接口案例：天气信息查询

一、接口

本API接口用于查询指定城市的天气信息，包括当前天气状况、未来几天的天气预报等。

二、请求URL

https://api.weather.com/v1/weather

三、请求方法

GET

四、请求参数

参数名	类型	是否必填	描述
city	string	是	城市名称，北京”
key	string	是	API密钥，用于身份验证

五、请求示例

https://api.weather.com/v1/weather?city=北京&key=your_api_key

六、响应数据格式

响应数据为JSON格式，具体结构如下：

字段名	类型	描述
current_weather	object	当前天气信息
forecast	array	未来几天的天气预报，每一天为一个对象

（一）current_weather对象

字段名	类型	描述
temperature	number	当前温度，单位为摄氏度
weather_condition	string	当前天气状况，如“晴”、“雨”等

（二）forecast数组中的对象

字段名	类型	描述
date	string	日期，格式为“YYYY-MM-DD”
temperature	number	当天的平均温度，单位为摄氏度
weather_condition	string	当天的天气状况，如“晴”、“雨”等

七、响应示例

{
    "current_weather": {
        "temperature": 25,
        "weather_condition": "晴"
    },
    "forecast": [
        {
            "date": "2024-12-01",
            "temperature": 23,
            "weather_condition": "晴"
        },
        {
            "date": "2024-12-02",
            "temperature": 20,
            "weather_condition": "多云"
        }
    ]
}

八、相关问题与解答

（一）问题一：如果忘记携带API密钥或者密钥错误会怎么样？