변경 이력

KernelHost API

시맨틱 버저닝을 따라요. 호환성을 깨는 변경(필드 이름 변경, 엔드포인트 제거, 인증 방식 변경)은 새 URL 접두사 /v2/ 아래의 새 메이저 버전에서만 발생해요. /v1/ 안에서는 추가적인 변경(새로운 선택 필드, 새로운 엔드포인트)만 이뤄져요.

v1.4.0 (2026-11-09)

  • 새 경로 GET /v1/services/{id}/metrics(read:services 권한): 1h, 6h, 24h, 7d, 14d 기간의 서버 지표를 제공합니다. Edge Unlimited Traffic VPS는 CPU, 메모리, 네트워크, 송신 트래픽 지표를, 일반 Unlimited Traffic VPS는 엔드포인트 레퍼런스에 나열된 위치에서 수신 및 송신 네트워크 지표를 제공합니다.
  • 새 경로 GET /v1/services/{id}/ddos/attacks 및 GET /v1/services/{id}/ddos/attacks/{attack_id}(read:ddos 권한): Remote DDoS Protection의 공격 보고서를 최대 90일까지 제공하며, 트래픽 추이와 프로토콜, 포트, 출발지, 패킷 크기별 세부 분석을 포함합니다.
  • 프로필 및 규칙(/ddos/profiles, /ddos/rules 및 쓰기 작업): 본인 계정의 서비스이지만 Advanced DDoS Protection 서비스가 아닌 경우 이제 HTTP 404 대신 HTTP 409 not_supported_for_product를 반환합니다. 알 수 없거나 다른 소유자의 서비스 ID는 계속 HTTP 404를 반환합니다.

v1.3.1 (2026-11-02)

  • 독일과 프랑스는 각각 선택할 수 있습니다. ‘독일(유럽)’은 독일 프랑크푸르트에서만, ‘프랑스(유럽)’는 프랑스에서만 제공됩니다.
  • 일반 Unlimited Traffic VPS의 유럽, 독일, 프랑스, 캐나다 동부, 영국, 폴란드 위치에서는 서버 제공까지 최대 7일이 걸릴 수 있습니다. 대부분의 경우 48시간 이내에 준비됩니다. 결제한 이용 기간은 서버를 전달받은 때부터 시작됩니다.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: 새 경로 4개를 통해 프로필과 규칙 조회, 규칙 추가 및 소유한 규칙 삭제를 지원합니다. read:ddos와 write:ddos를 명시적으로 활성화하세요. 기존 키에는 새 권한이 부여되지 않습니다.
  • 패널과 API의 공통 한도, 순차 변경 처리, POST와 DELETE의 필수 Idempotency-Key로 규칙 대량 전송과 병렬 요청을 방지합니다.

v1.2.2 (2026-10-27)

  • POST /v1/orders: 결제된 서비스를 바로 프로비저닝할 수 없는 경우, 이제 해당 서비스의 ID는 provisioning_failures 필드(status partial)가 아니라 awaiting_setup 필드(status awaiting_setup)에 표시됩니다. 서비스는 가능해지는 즉시 자동으로 프로비저닝되며 이후 active로 바뀝니다. 이 경우 다시 주문하지 마세요.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: 유럽, 미주, 아시아, 중동, 아프리카, 호주에 추가 요금이 있는 새 위치가 추가되었습니다. GET /v1/products/{id}는 이 위치들을 표시 이름 및 추가 요금과 함께 표시합니다. 이러한 위치가 현재 품절이면 POST /v1/orders는 HTTP 409 location_sold_out을 반환합니다. 위치를 지정하지 않으면 계속 목록의 첫 번째 위치(Europe)가 적용됩니다.
  • Dedicated Unlimited Traffic VPN 및 Dedicated High Speed Unlimited Traffic VPN 요금제의 구성 옵션(위치와 운영체제)과 그 하위 옵션에 새 ID가 부여되었습니다. ID는 GET /v1/products/{id}에서 읽어 오세요. 코드에 고정된 이전 ID는 HTTP 400 validation_failed를 반환합니다. 이 변경 전에 이미 status가 cancelled, terminated 또는 fraud였던 이 요금제의 서비스는 GET /v1/services/{id}의 location 값이 null입니다. High Speed VPN은 이제 Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe), Poland (Europe) 위치 옵션으로만 주문할 수 있습니다.
  • Edge Unlimited Traffic VPS: 새 위치 6곳(프랑크푸르트암마인, 런던, 체스터, 파리, 바르샤바, 워싱턴 D.C.)이 추가되어 최대 25개 위치가 되었습니다. 새 위치에는 고유한 sub_option_id 값이 있으며, 기존 위치의 ID는 그대로입니다. 일부 요금제는 기본 가격과 위치별 추가 요금의 배분이 바뀌었지만 기존 위치의 총 가격은 동일합니다. ID와 가격은 항상 GET /v1/products/{id}에서 읽어 오세요.

v1.2.0 (2026-10-24)

  • 위치를 선택하는 제품(Edge Unlimited Traffic VPS)의 POST /v1/orders: 위치 옵션에는 기본값이 없으므로 config_options에 반드시 포함해야 하며, 없으면 reason location_required와 함께 HTTP 422가 반환됩니다. 품절된 위치는 HTTP 409 location_sold_out을 반환합니다. 새 선택 필드 storage_gb로 전체 스토리지를 20~300 GB 범위에서 지정합니다. 20 GB는 요금제 가격에 포함되어 있으며 필드를 생략하면 적용되고, 추가 1 GB마다 GET /v1/products/{id}에 표시된 가격이 청구됩니다. 그 밖의 값은 HTTP 422 storage_out_of_range를 반환합니다.
  • 이 제품의 주문 결과에는 location과 storage_gb(GB 단위 전체 스토리지)가 포함되며, GET /v1/products/{id}는 storage 필드에서 스토리지 범위와 추가 1 GB당 가격을 안내합니다. GET /v1/services와 GET /v1/services/{id}는 모든 서비스에 대해 location과 storage_gb를 반환합니다(제품에 해당 선택이 없으면 null).
  • GET /v1/products/{id}는 이제 하위 옵션을 표시 이름으로만 반환합니다(예: "Finland (Europe)"). 앞에 붙던 내부 값은 더 이상 포함되지 않습니다. POST /v1/orders는 현재 품절된 제품을 HTTP 409 out_of_stock으로 거부합니다.

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.