RACCO API / v1

あなたの実績を、
いつものツールへ。

RACCOに記録した稼働実績を、AIやスクリプトから読み取れます。APIキー1本で、自分の案件・月次・日別の実績にアクセス。

読み取り専用 · 日本時間 · 時間は分単位

はじめる

1. 設定 → API連携でAPIキーを発行します。
2. 秘密情報ストアから環境変数 RACCO_API_KEY にキーを設定します。
3. 月次APIを呼び出します。

curl --fail-with-body \
  --header "Authorization: Bearer $RACCO_API_KEY" \
  'https://app.racco-app.link/api/external/v1/reports/monthly?month=2026-10'

import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://app.racco-app.link/api/external/v1/reports/monthly?month=2026-10",
    headers={"Authorization": f"Bearer {os.environ['RACCO_API_KEY']}"},
)
with urlopen(request, timeout=30) as response:
    report = json.load(response)
print(json.dumps(report, ensure_ascii=False, indent=2))

AIに接続する場合も、キーはツールの秘密情報設定に保存してください。プロンプト・公開リポジトリ・URLには含めません。このページにキーを入力する必要はありません。

認証とキー管理

Authorization: Bearer <APIキー>

キーに紐づく本人の実績だけを取得します。ユーザーIDを指定して対象を切り替えることはできません。APIキーでは管理・更新APIを操作できません。

ENDPOINT

本人の月次実績

GET /reports/monthly

日本時間・分単位。稼働中を含む。月ごと・案件ごとに集計し、メモ・勤務時刻・契約条件は返さない。

クエリパラメーター

リクエスト例

curl --fail-with-body \
  --header "Authorization: Bearer $RACCO_API_KEY" \
  'https://app.racco-app.link/api/external/v1/reports/monthly?month=2026-10'

成功時は 200。該当する案件がない場合は data: [] を返します。

ENDPOINT

本人の期間指定実績（最大366日、両端を含む）

GET /reports/range

日本時間・分単位。稼働中を含む。月ごと・案件ごとに集計し、メモ・勤務時刻・契約条件は返さない。

クエリパラメーター

リクエスト例

curl --fail-with-body \
  --header "Authorization: Bearer $RACCO_API_KEY" \
  'https://app.racco-app.link/api/external/v1/reports/range?from=2026-10-01&to=2026-10-31'

成功時は 200。該当する案件がない場合は data: [] を返します。

レスポンス

案件・月ごとの集計を data に返します。以下は説明用の架空データです。

{
  "data": [
    {
      "month": "2026-10",
      "projectId": "00000000-0000-4000-8000-000000000001",
      "projectName": "サンプル案件",
      "actualMinutes": 480,
      "billableMinutes": 480,
      "breakMinutes": 60,
      "workDays": 1,
      "days": [
        {
          "date": "2026-10-01",
          "actualMinutes": 480,
          "billableMinutes": 480,
          "breakMinutes": 60
        }
      ]
    }
  ],
  "serverNow": "2026-10-16T09:00:00.000Z"
}

案件・月ごとの集計

日別の実績

エラーと制限

各外部ルートは全ユーザー合計で毎秒5リクエスト・バースト10を目安に制限します。ベストエフォート制御のため、必ずこの回数まで成功する保証はありません。APIレスポンスはキャッシュしません。

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "有効なAPIキーが必要です"
  },
  "requestId": "example-request-id"
}