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. 認證方式

3. GraphQL

特點：
- 按需查詢
- 強型別
- 單一端點
- 即時訂閱

🛠️ 應用能力

能力 1：RESTful 呼叫

小蔥技能有更好的技能skills外掛。

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
狀態： ✅ 學習完成

這個技能質量中規中矩，涵蓋 API 呼叫的基本知識點，但內容比較淺顯。對於剛入門的新手來說還算友好，能瞭解大概知識框架，但實用性和可操作性不足。如果你需要實際做 API 整合工作，可能會覺得學完還是不太會用，建議配合其他更詳細的教程學習。