自学API笔记详解

来看看文心一言字怎么说：

 chatGPT3.5:

 API， 接口(interface)， 协议（protocol）

下图：介绍API、接口和协议之间的关系：

  在这个图示中，软件应用程序是整个系统的核心，包含各种不同的功能和模块。它通过接口与外部世界进行交互，并通过API实现与其他应用程序或服务的集成。

  接口是一个简单的抽象层，它为外部用户提供了访问软件应用程序的通道。通过使用接口，软件应用程序可以隐藏其内部实现细节，并使外部调用者可以直接访问该应用程序的某些功能或特性。

  协议是指通信双方之间进行数据交换和共享信息所应遵循的严格规则和标准。系统中的各个设备和其他网络服务使用协议进行通信，以便彼此之间能够有效地交流。

  API是一组定义在接口之上的函数、方法、请求和响应，它为应用程序提供了对其他应用程序或服务的访问。这些API可以使用不同的协议来实现与其他应用程序或服务的集成。

  总而言之，接口为软件应用程序提供了与外部环境交互的通道，协议提供了参与通信的设备和服务之间仔细制定的规则，API为外部应用程序和服务提供了访问软件应用程序功能的桥梁。

 格式（XML、json）

  XML（Extensible Markup Language）是一种用于标记和描述数据的语言，它是SGML（Standard Generalized Markup Language）的一种应用。与HTML（Hypertext Markup Language）不同，XML是一种“可扩展”的标记语言，它不局限于固定的标记集合，而是允许开发者根据需要自定义标记。

XML的主要特点包括：

1. 可扩展性：XML允许开发者根据需要自定义标记，使得数据的存储和传输更加灵活。
2. 结构化：XML数据可以通过树形结构（DOM）或文本格式（SAX）进行解析和处理。
3. 纯文本：XML是一种纯文本格式，易于阅读和编辑，并且不需要特殊的软件来解析。
4. 跨平台：XML可以在不同的操作系统、编程语言和应用程序之间进行传输和共享。

  在Web开发中，XML常用于数据传输、Web服务、内容管理和数据存储等方面。例如，使用XML传输数据可以使得不同平台和语言的应用程序之间实现互操作性；Web服务可以使用XML进行数据交换，从而实现应用程序之间的通信和集成；内容管理系统可以使用XML来存储和管理网站内容，从而实现动态生成网页等功能。

---

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，易于阅读和编写。它常用于数据交换、Web服务、移动应用程序等方面。

JSON格式通常由以下三部分组成：

1. 数据类型：在JSON中，数据类型包括对象（Object）、数组（Array）、字符串（String）、数字（Number）和布尔值（Boolean）。
2. 结构：JSON中的数据结构包括键值对（key-value pair）和嵌套结构（nested structure）。在JSON中，对象是一个无序的键值对集合，而数组则是一个有序的元素集合。
3. 语法：JSON的语法包括花括号（{}）、方括号（[]）、冒号（:）、逗号（,）等。其中，冒号用于表示键值对，花括号用于表示对象，方括号用于表示数组。

JSON具有以下特点：

1. 易于读取：与XML相比，JSON更加简洁明了，可以轻松地在不同应用程序和语言之间进行数据交换。
2. 数据传输速度更快：由于JSON比XML更轻量级，因此在数据传输速度上更快。
3. 支持多种编程语言：由于JSON易于理解和使用，因此许多编程语言都支持JSON格式。

   在Web开发中，JSON常用于数据传输、Web服务、内容管理和数据存储等方面。例如，使用JSON传输数据可以使得不同平台和语言的应用程序之间实现互操作性；Web服务可以使用JSON进行数据交换，从而实现应用程序之间的通信和集成；内容管理系统可以使用JSON来存储和管理网站内容，从而实现动态生成网页等功能。

API基础功能

 1、API 能确认所有的操作都是合法的。

 2、API内置授权和访问控制权限，以及速率限制，保障数据安全。

 3、API会根据错误报告机制发出指示以及自动分页、过滤查询，（提高网络、服务器资源利用率）减轻开发人员的负担。

使用Python调用API的具体操作步骤如下：

1、寻找适合自己需求的API

在互联网上寻找一个合适的API，比如需要从Twitter获取数据，可以通过Twitter提供的API来实现

2、注册并获取API Key

向该API提供商申请一个API Key或者Access Token。API Key可以保护API免于恶意请求和滥用，并且对于某些API来说也是访问权限的标记。

3、调用API

在Python中使用requests库调用API。主要的HTTP请求方法有GET, POST, PUT, DELETE和PATCH。例如，如果某个API的URL为https://api.example.com/data，则可以使用requests库发送GET请求以获取数据：

import requests

response = requests.get('https://api.example.com/data')

data = response.json()

4、解析响应

API通常会返回JSON格式的数据，我们可以通过json模块将其解析成Python中的字典对象或列表对象。如果API返回XML格式的数据，则可以使用xml.etree.ElementTree模块进行解析。

5、处理异常

在请求API时可能会出现诸如网络连接失败、请求超时或者API返回错误信息等异常情况，需要考虑在程序中进行异常处理。

    总而言之，调用API的主要步骤包括查找适合需求的API，注册并获取API Key，调用API获取响应数据，解析响应数据并进行异常处理。

---

END(●'◡'●)