APIリファレンス API reference

管理者ポータルが使うインターフェースは大きく 4 種類: Cloudflare Workers BFF（/v1/*、OpenAPI 3.1 契約）、 Supabase Auth（SDK 直接）、Supabase Realtime（WebSocket）、外部 API（Mapbox 等）。 詳細な契約は parky/api/openapi.json を参照してください。

The portal talks to four kinds of interfaces: the Cloudflare Workers BFF (/v1/*, OpenAPI 3.1 contract), Supabase Auth (direct SDK), Supabase Realtime (WebSocket), and external APIs (Mapbox etc.). See parky/api/openapi.json for the full contracts.

完全な一覧と試し打ちは Swagger UI / Redoc を参照。 ここでは「画面とエンドポイントの対応」を把握するためのハイライトを掲載します。

For the full list and interactive tryouts use Swagger UI / Redoc. This page highlights the endpoints whose shape lines up 1-to-1 with admin screens.

1. PostgreSQL RPC（Workers から呼び出し）PostgreSQL RPC (invoked from Workers)

2. Cloudflare Workers BFF（管理ポータルが主に叩く経路）Cloudflare Workers BFF (the main admin-portal path)

3. Realtime (WebSocket)

4. Supabase Auth Admin

管理者アカウントの作成・パスワード変更・削除は service_role キーが必須です。 この鍵はクライアントに露出させず、バックオフィス専用の別クライアント (supabaseAdmin) から呼びます。

Creating, updating, or deleting admin accounts requires the service_role key. It must never ship to non-admin clients — call it from the dedicated supabaseAdmin client instead.

5. 外部 APIExternal APIs

典型的な使用例 Common usage patterns

1. ページング付き一覧取得Paged list

const { rows, total } = await fetchTablePage({
  table: 'app_users',
  search: { display_name: 'ilike.%john%' },
  order: { column: 'created_at', ascending: false },
  offset: 0,
  limit: 500,
});

2. 駐車場詳細の複数フェッチParking-detail fanout

const [lot, sessions, reviews, reports, engagement] = await Promise.all([
  fetchParkingLot(id),
  fetchParkingSessions({ parkingLotId: id }),
  fetchParkingReviews({ parkingLotId: id }),
  fetchErrorReports({ parkingLotId: id }),
  fetchParkingLotEngagementForLot(id),
]);

3. アセットアップロードAsset upload

// 1. Ask the Workers BFF for a presigned R2 URL
const { upload_url, asset_id, s3_key } = await bff.storage.uploadUrl({
  file_name, file_size, mime_type, category: 'badge_icon', is_public: true,
});
// 2. PUT the file directly to R2
await fetch(upload_url, { method: 'PUT', body: file });
// 3. Link the asset_id on the target row
await updateBadgeDefinition(badge.id, { asset_id });

4. Realtime 購読Subscribe to realtime

const channel = supabase
  .channel('live-user-activity')
  .on('postgres_changes',
      { event: 'INSERT', schema: 'public', table: 'user_activity_logs' },
      (payload) => setLogs(prev => [payload.new, ...prev]))
  .subscribe();