하우투 가이드›첫 번째 예약 생성하기

첫 번째 예약 생성하기

이 가이드는 API 키 발급부터 예약된 작업 요청까지 전 과정을 다섯 단계로 안내합니다.

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"

작업 요청 생성

하나 이상의 희망 날짜 시간대와 함께 예약을 생성한 뒤, 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"}]}]}'

‹ 이전응답 엔벨로프

다음 ›증분 데이터 동기화

이 페이지 내용