REST API リファレンス

シート一覧を取得

自分のシート一覧を取得します。

クエリパラメータ

リクエスト例

curl -X GET "https://sparksheets.ai/api/v1/sheets" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx"

レスポンス例

{
  "success": true,
  "sheets": [
    {
      "id": "abc123",
      "title": "プロジェクト計画",
      "content": {
        "col1": "<p>内容...</p>"
      },
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-15T14:22:00Z"
    }
  ],
  "total": 42
}

シートを検索

キーワードでシートを検索します。タイトルと本文の両方が検索対象です。

リクエスト例

curl -X GET "https://sparksheets.ai/api/v1/sheets?q=プロジェクト" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx"

シートを取得

特定のシートの内容を取得します。

リクエスト例

curl -X GET "https://sparksheets.ai/api/v1/sheets/abc123" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx"

シートを作成

新しいシートを作成します。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/sheets" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "新しいシート",
    "content": {
      "col1": "<p>内容をここに</p>"
    },
    "tags": ["work", "important"]
  }'

レスポンス例

{
  "success": true,
  "id": "xyz789",
  "title": "新しいシート"
}

シートを更新

既存のシートを更新します。

リクエストボディ

リクエスト例

curl -X PUT "https://sparksheets.ai/api/v1/sheets/abc123" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "更新されたタイトル",
    "content": {
      "col1": "<p>更新された内容</p>"
    }
  }'

シートを削除

シートをゴミ箱に移動します。

リクエスト例

curl -X DELETE "https://sparksheets.ai/api/v1/sheets/abc123" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx"

セッション一覧を取得

保存されたセッション一覧を取得します。

クエリパラメータ

リクエスト例

curl -X GET "https://sparksheets.ai/api/v1/sessions?project=sparksheets" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx"

レスポンス例

{
  "success": true,
  "sessions": [
    {
      "id": "sess_abc123",
      "title": "API統一作業",
      "summary": "REST API、MCP、Webhooksの機能を統一...",
      "project": "sparksheets",
      "tags": ["api", "refactoring"],
      "createdAt": "2025-01-15T10:30:00Z"
    }
  ]
}

セッションを保存

開発セッションの要約を保存します。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/sessions" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "API統一作業 Day 1",
    "summary": "REST APIエンドポイントを8個追加、MCP toolsを25個に拡張",
    "project": "sparksheets",
    "tags": ["api", "mcp"],
    "files_changed": ["api/v1/sessions", "api/v1/spark"]
  }'

引き継ぎシートを作成

次のセッション用の引き継ぎシートを自動生成します。

リクエストボディ

解決策を検索

過去に保存したエラー解決策を検索します。

クエリパラメータ

リクエスト例

curl -X GET "https://sparksheets.ai/api/v1/knowledge?type=solutions&q=CORS" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx"

レスポンス例

{
  "success": true,
  "solutions": [
    {
      "id": "sol_abc123",
      "title": "CORSエラーの解決方法",
      "error": "Access-Control-Allow-Origin header is missing",
      "content": "サーバー側でCORSヘッダーを追加する...",
      "language": "php",
      "tags": ["cors", "api"],
      "createdAt": "2025-01-10T09:00:00Z"
    }
  ]
}

解決策を保存

エラーの解決策を保存します。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/knowledge?type=solutions" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "PHPのタイムゾーン警告を解消",
    "error": "date(): It is not safe to rely on the system'\''s timezone settings",
    "content": "php.iniまたはスクリプト内でdate_default_timezone_set('\''Asia/Tokyo'\'');を設定する",
    "language": "php",
    "tags": ["php", "timezone"]
  }'

スニペットを保存・取得

よく使うコードスニペットを保存・取得します。使い方は解決策と同様です。

Spark一覧を取得

利用可能なSpark（AIボタン）の一覧を取得します。

レスポンス例

{
  "success": true,
  "sparks": [
    {
      "id": "spark_summarize",
      "name": "要約",
      "description": "テキストを簡潔に要約します",
      "icon": "auto_awesome",
      "category": "writing",
      "type": "public"
    },
    {
      "id": "spark_custom_001",
      "name": "カスタムSpark",
      "description": "ユーザー作成のSpark",
      "icon": "star",
      "category": "custom",
      "type": "user"
    }
  ]
}

Sparkを実行

指定したSparkを実行してAI処理を行います。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/spark" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "spark_id": "spark_summarize",
    "content": "長いテキストをここに入力..."
  }'

レスポンス例

{
  "success": true,
  "spark_id": "spark_summarize",
  "spark_name": "要約",
  "result": "AIによる処理結果..."
}

テキストを翻訳

テキストを指定した言語に翻訳します。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/spark?action=translate" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "こんにちは、世界！",
    "target_lang": "en"
  }'

レスポンス例

{
  "success": true,
  "target_lang": "en",
  "result": "Hello, world!"
}

統計を取得

使用量の統計情報を取得します。

レスポンス例

{
  "success": true,
  "stats": {
    "sheets": {
      "total": 42,
      "created_this_month": 8
    },
    "sparks": {
      "executed_total": 156,
      "executed_this_month": 23
    },
    "worktime": {
      "total_hours": 120.5,
      "this_month_hours": 32.0
    },
    "sessions": {
      "total": 28,
      "this_month": 5
    },
    "recent_work_logs": [...]
  }
}

作業時間を記録

プロジェクトごとの作業時間を記録します。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/stats?action=worktime" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "sparksheets",
    "hours": 2.5,
    "description": "API実装とドキュメント作成"
  }'

Todo一覧を取得

タスク一覧を取得します。

クエリパラメータ

レスポンス例

{
  "success": true,
  "todos": [
    {
      "id": "todo_abc123",
      "content": "REST APIドキュメントを拡張",
      "status": "in_progress",
      "project": "sparksheets",
      "priority": "high",
      "createdAt": 1705312200000
    }
  ]
}

Todoを同期

タスクを一括で同期します。既存のタスクは更新、新規は追加されます。

リクエストボディ

リクエスト例

curl -X POST "https://sparksheets.ai/api/v1/todos" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "sparksheets",
    "todos": [
      {"content": "APIドキュメント作成", "status": "completed"},
      {"content": "Webhookテスト", "status": "in_progress"}
    ]
  }'

APIキー一覧を取得

発行済みのAPIキー一覧を取得します（キー本体は表示されません）。

レスポンス例

{
  "success": true,
  "api_keys": [
    {
      "id": "key_abc123",
      "name": "Production API",
      "prefix": "sk_1234...",
      "created_at": "2025-01-10T09:00:00Z",
      "last_used_at": "2025-01-15T14:30:00Z"
    }
  ]
}

APIキーを作成

新しいAPIキーを発行します。

リクエストボディ

レスポンス例

{
  "success": true,
  "api_key": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "id": "key_abc123",
  "name": "Production API"
}

APIキーを削除（無効化）

APIキーを無効化します。無効化されたキーは即座に使用できなくなります。

Webhook一覧を取得

Webhookを登録

リクエストボディ

利用可能なイベント

• sheet.created - シート作成時
• sheet.updated - シート更新時
• sheet.deleted - シート削除時
• spark.executed - Spark実行時
• session.saved - セッション保存時
• session.handover - 引き継ぎ作成時
• knowledge.saved - ナレッジ保存時

Webhookを削除