SWAPI API介绍

概述

SWAPI是一个网络公共API，提供了与星球大战电影宇宙中相关内容有关的信息。这包括电影、人物、行星、飞船、车辆和其他星球大战宇宙的元素。

API的基本URL为 https://swapi.dev/api/ 。

人物信息API

本次介绍的主题是SWAPI API中的人物信息API。人物信息API提供了有关星球大战电影宇宙中所有人物的信息。

人物信息API的基本URL为 https://swapi.dev/api/people/ 。

请求和响应格式

发送一个 HTTP GET 请求到人物信息API的基本URL，即可获取所有人物的信息。HTTP响应将包含一个JSON对象，其中包含所有人物的详细信息。

以下是示例响应：

{
    "count": 87,
    "next": "https://swapi.dev/api/people/?page=2",
    "previous": null,
    "results": [
        {
            "name": "Luke Skywalker",
            "height": "172",
            "mass": "77",
            "hair_color": "blond",
            "skin_color": "fair",
            "eye_color": "blue",
            "birth_year": "19BBY",
            "gender": "male",
            "homeworld": "https://swapi.dev/api/planets/1/",
            "films": [
                "https://swapi.dev/api/films/1/",
                "https://swapi.dev/api/films/2/",
                "https://swapi.dev/api/films/3/",
                "https://swapi.dev/api/films/6/"
            ],
            "species": [
                "https://swapi.dev/api/species/1/"
            ],
            "vehicles": [
                "https://swapi.dev/api/vehicles/14/",
                "https://swapi.dev/api/vehicles/30/"
            ],
            "starships": [
                "https://swapi.dev/api/starships/12/",
                "https://swapi.dev/api/starships/22/"
            ],
            "created": "2014-12-09T13:50:51.644000Z",
            "edited": "2014-12-20T21:17:56.891000Z",
            "url": "https://swapi.dev/api/people/1/"
        },
        //...
    ]
}

响应字段说明

• count: 星球大战电影宇宙中所有人物的数量
• next:API中包含剩余结果的URL（如果有的话）
• previous: API中包含之前结果的URL（如果有的话）
• results: 包含所有人物信息的数组

人物信息对象包含以下字段：

• name: 人物姓名
• height: 人物身高
• mass: 人物体重
• hair_color: 人物头发颜色
• skin_color: 人物肤色
• eye_color: 人物眼睛颜色
• birth_year: 人物出生日期
• gender: 人物性别
• homeworld: 人物母星
• films: 人物参演的电影
• species: 人物种族
• vehicles: 人物乘坐的交通工具
• starships: 人物驾驶的宇宙飞船
• created: 人物信息创建日期
• edited: 人物信息最后编辑日期
• url: 人物信息API的具体URL

限制和注意事项

• API链接中包含的任何参数都应该是urlencode的。
• 单个请求返回结果的最大数量为10,000条数据。
• 带有特定参数的某些查询可能需要较长时间才能返回结果。在这种情况下，客户端可能需要主动取消请求，或者服务器可能会在后台继续处理请求。

以上就是SWAPI API中人物信息API的介绍。希望对使用SWAPI API的开发者们有所帮助！