- 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 状态： ✅ 学习完成