公開API

kasaneru は、外部ツールから空き時間を取得するための公開 HTTP API を提供しています。

このページは概要と導線のみをまとめたものです。完全な契約は OpenAPI / Redoc を参照してください。

できること

• PAT を使って自分の空き時間を取得する
• PAT を使ってグループの空き時間を取得する
• アプリ上で PAT を発行、一覧表示、失効する

認証

• PAT 管理 API: Firebase ID トークン
• 空き時間クエリ API: PAT (Authorization: Bearer ksr_pat_<keyId>_<secret>)

平文の PAT は発行時に一度だけ表示されます。

ベースURL

• https://api.kasaneru.nekonata.dev

主要エンドポイント

• POST /v1/api-keys
• GET /v1/api-keys
• DELETE /v1/api-keys/{keyId}
• POST /v1/availability/query/me
• POST /v1/availability/query/group

仕様書

• Redoc API リファレンス
• OpenAPI JSON

公開ドメイン:

• https://kasaneru.nekonata.dev

クライアント生成例:

npx @openapitools/openapi-generator-cli generate \
  -i https://kasaneru.nekonata.dev/openapi/public-api.json \
  -g typescript-axios \
  -o ./src/generated-api