🔌 api-integration - API 集成技能

---

name: api-integration

description: API 集成技能 - 掌握 RESTful API 调用、GraphQL 支持、API 认证管理等核心能力

author: 滚滚 & 地球人

version: 1.0.0

updated: 2026-03-15

---

# 🔌 api-integration - API 集成技能

**Slogan：** 连接世界，集成万物

---

📋 技能描述

**提供完整的 API 集成能力，从 RESTful 到 GraphQL，**

**帮助 AI Agent 快速接入第三方服务，扩展能力边界。**

---

🎯 核心知识

1. RESTful API

HTTP 方法：
- GET - 获取资源
- POST - 创建资源
- PUT - 更新资源
- DELETE - 删除资源

状态码：
- 200 - 成功
- 201 - 创建成功
- 400 - 请求错误
- 401 - 未授权
- 404 - 资源不存在
- 500 - 服务器错误

---

2. 认证方式

| 方式 | 说明 | 安全性 |

|------|------|--------|

| **API Key** | 简单密钥 | 中 |

| **OAuth2** | 授权框架 | 高 |

| **JWT** | Token 认证 | 高 |

| **Basic Auth** | 基础认证 | 低 |

---

3. GraphQL

特点：
- 按需查询
- 强类型
- 单一端点
- 实时订阅

---

🛠️ 应用能力

能力 1：RESTful 调用

import requests

def call_api(endpoint, method='GET', data=None, headers=None):
    response = requests.request(
        method=method,
        url=endpoint,
        json=data,
        headers=headers
    )
    response.raise_for_status()
    return response.json()

能力 2：认证管理

# OAuth2 认证
def get_oauth_token(client_id, client_secret):
    response = requests.post(
        'https://api.example.com/oauth/token',
        data={
            'grant_type': 'client_credentials',
            'client_id': client_id,
            'client_secret': client_secret
        }
    )
    return response.json()['access_token']

能力 3：错误处理

def safe_api_call(endpoint):
    try:
        return call_api(endpoint)
    except requests.exceptions.HTTPError as e:
        if e.response.status_code == 404:
            return {'error': 'Resource not found'}
        elif e.response.status_code == 401:
            return {'error': 'Unauthorized'}
        else:
            return {'error': str(e)}

---

💚 滚滚的话

**好的 API 集成，**

**稳定、安全、高效。**

**滚滚陪你一起，**

**连接更多服务！** 🔌💚

---

**创建人：** 滚滚 & 地球人

**创建时间：** 2026-03-15

**状态：** ✅ 学习完成