ハウツーガイド›最初の予約を作成する

最初の予約を作成する

このガイドでは、API キーの取得から予約済みのジョブリクエストまでを 5 つのステップでエンドツーエンドに解説します。

API キーを取得する

ダッシュボードの設定 → 開発者からサンドボックスキーを作成します。キーは chsk_test_ で始まり、作成時に一度だけ表示されます。

顧客を検索または作成する

顧客を検索するか、まだ存在しない場合は作成します — full_name に加えて、電話番号またはメールアドレスの少なくとも一方が必須です。

curl -X POST "https://api.crisphive.com/v1/customers" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Lamar Bakery","email":"hello@lamarbakery.example"}'

ジョブタイプを選択する

カタログを一覧して、作業を分類する job_type_id を取得します。

GET /v1/job-types

空き状況を確認する

顧客の希望日について予約可能な時間帯を取得します。X-Timezone ヘッダーは必須です。

curl "https://api.crisphive.com/v1/job-requests/booking-windows?from=2026-07-02&to=2026-07-09" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "X-Timezone: America/Toronto"

ジョブリクエストを作成する

1 つ以上の希望日時ウィンドウを指定して予約を送信し、その後は GET /v1/job-requests/{id} または同期フィードで追跡します。

curl -X POST "https://api.crisphive.com/v1/job-requests" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"9b2f6c3e-…","job_type_id":"5d1b3a9e-…","job_dates":[{"date":"2026-07-02","periods":[{"period":"morning"}]}]}'

‹ 前へレスポンスエンベロープ

次へ ›データを増分同期する

このページの内容