课程 18：应用程序接口（API）

1. API基础

1.1 什么是API？

1.2 API的作用

2. 常见API类型

2.1 库API

# 调用Python标准库API
import math
print(math.sqrt(16))
import random
print(random.randint(1, 10))

2.2 Web API

# 调用Web API（以requests库为例）
import requests
response = requests.get('https://api.github.com')
print(response.status_code)
print(response.json())

3. API的调用方法与文档

3.1 标准库API调用

import os
print(os.getcwd())  # 获取当前工作目录
print(os.listdir('.'))  # 列出当前目录下的文件

3.2 查阅API文档

help(math.sqrt)
help(requests.get)

4. 自定义API设计与调用

4.1 设计自定义API（函数）

def add(a, b):
    """返回a和b的和"""
    return a + b
print(add(3, 5))

4.2 参数与返回值

def greet(name, lang='zh'):
    if lang == 'zh':
        return f"你好, {name}!"
    else:
        return f"Hello, {name}!"
print(greet('Alice'))
print(greet('Bob', lang='en'))

5. API的实际应用案例

5.1 数据获取与处理

# 获取天气数据（伪代码，需替换为真实API）
import requests
url = 'https://api.example.com/weather?city=Beijing'
response = requests.get(url)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print('获取失败')

5.2 第三方API集成

# 使用百度翻译API（伪代码，需注册API Key）
import requests
url = 'https://fanyi.baidu.com/api/trans/vip/translate'
params = {'q': 'hello', 'from': 'en', 'to': 'zh', 'appid': '你的appid', 'salt': '随机数', 'sign': '签名'}
response = requests.get(url, params=params)
print(response.json())

6. 常见错误与调试

try:
    response = requests.get('https://api.github.com/unknown')
    response.raise_for_status()
except requests.RequestException as e:
    print('请求失败:', e)

7. 编程练习与挑战

8. 综合作业与项目