시맨틱 버저닝을 따라요. 호환성을 깨는 변경(필드 이름 변경, 엔드포인트 제거, 인증 방식 변경)은 새 URL 접두사 /v2/ 아래의 새 메이저 버전에서만 발생해요. /v1/ 안에서는 추가적인 변경(새로운 선택 필드, 새로운 엔드포인트)만 이뤄져요.
v1.1.0 (2026-09-23)
- POST /v1/orders: config_options는 스토어에 표시되는 옵션과 값만, 수량은 허용 범위 내에서만 받습니다. 지정하지 않은 표시 옵션에는 스토어와 똑같이 목록의 첫 번째 값이 적용됩니다. GET /v1/products/{id}는 주문 가능한 옵션만 표시하고 quantity.min과 quantity.max를 반환합니다.
- KernelHost 팀이 수동으로 설정하는 제품을 위한 새 주문 상태 awaiting_setup과 awaiting_setup 필드가 추가되었습니다. 자동 프로비저닝 서비스는 정확히 한 번만 프로비저닝됩니다.
- 요청 body는 64 KB로 제한됩니다(HTTP 413). 계정별로 모든 키를 합산해 분당 120개 요청 제한이 적용되며, 계정당 최대 20개의 활성 키를 보유할 수 있습니다. 인증 실패로 더 이상 키가 잠기지 않으며, Idempotency-Key는 메서드와 경로에 연결됩니다.
- 쿼리 매개변수가 두 개 이상인 요청(예: GET /v1/services?limit=10&offset=0)이 HTTP 401로 거부되던 문제를 수정했습니다. 이제 서명은 문서에 설명된 대로 쿼리 문자열을 정확히 포함합니다.
v1.0.0 (2026-05-14)
- 최초 릴리스. 전체 15개 엔드포인트, HMAC 인증, AES-GCM 시크릿 저장, 속도 제한, 멱등성, 감사 로그 포함.
- GET
/v1/me,/v1/products,/v1/products/{id} - POST
/v1/orders, GET/v1/orders/{id} - GET
/v1/services,/v1/services/{id},/v1/services/{id}/credentials - POST
/v1/services/{id}/actions - GET
/v1/billing/balance,/v1/billing/invoices,/v1/billing/invoices/{id}/pdf - GET/PUT
/v1/webhooks - HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.
