주문

권한: orders:read.

GET /api/v1/orders

파라미터: offset, limit, family, status, client_reference(정확히 일치).

알 수 없는 family 또는 status 값은 “필터 없음”으로 처리됩니다. 정렬 순서는 고정이며 바꿀 수 없습니다: 최신순.

필드	의미
product, kind, family	구매한 것. kind: resident 또는 ipv4
quantity	구매한 단위 수: ipv4는 주소 수. 트래픽 주문은 항상 1 - 패키지 하나를 구매했으며, 용량은 packages[].traffic.purchased_gb에 있음
price_per_proxy, total	단가(total / quantity)와 주문 금액. 트래픽 주문은 둘이 같음
status	아래 참고
applied_to_package_id	값이 있으면 기존 패키지에 적용된 주문: 트래픽 추가 또는 주소 연장
client_reference	구매 본문에 넣은 내 라벨
packages	주문으로 발급된 트래픽 패키지. 트래픽 추가 주문과 고정 주소 주문은 비어 있음 - 해당 패키지는 GET /api/v1/packages?family=dedicated로 읽으며, 카드에 order_id가 있음

GET /api/v1/orders/{id}

형식은 목록과 같습니다. 다른 계정의 주문은 code 키 없이 404로 응답합니다.

발급 상태

구매는 요청 안에서 완료되므로 POST /api/v1/packages 응답의 주문은 이미 completed입니다. 나머지 상태는 주문을 조회할 때 나타납니다.

상태	할 일
pending, provisioning	5-10초마다 조회
completed	완료: 트래픽 패키지는 packages[0]에, 주소 패키지는 구매 응답의 package_id에
failed	금액이 차감되지 않았거나 반환됨, 재시도 가능
refunded	지원팀 결정으로 금액 반환됨. 새 구매로 재시도
needs_attention	금액 차감됨, 수동으로 처리 중. 다시 구매하지 말고 지원팀에 문의

주문을 조회하는 대신 이벤트 로그를 읽을 수 있습니다.