커스텀몰 API  /  개인정보·검수

개인정보·검수 체크리스트

개인정보

• 소유자와 맞지 않는 주문·배송·회원 정보는 절대 돌려주지 마세요(404).
• 필요한 필드만 보내 주세요. 카드·계좌·주민등록번호·비밀번호·관리자 메모는 보내지 않아요.
• buyer·receivers·회원의 이름·전화·이메일은 마스킹해 주세요(예: ki***@example.com, 010-****-5821). 카페24 응답을 통째로 넘기지 마세요.
• API 키는 로그에 남기지 말고, 콘솔에서 발급 → 전환 2단계로 교체해요. 전환 전까지는 이전 키도 유효해요.

검수 체크리스트

v1.0

• 키가 없거나 틀리면 401
• /v1/orders에 소유자(member_id·buyer_cellphone)가 없으면 400
• 남의 주문은 404, 본인 주문은 200
• limit 50 초과는 50으로 자르고, next_cursor로 끝까지 순회
• ID와 금액은 문자열, 금액에는 currency, 시각은 ISO 8601
• 필드 이름은 카페24와 같고, 품목 order_status는 카페24 코드
• 품목 image는 비어 있지 않은 절대 https URL (옵션 사진이 없으면 상품 대표 이미지)
• 콘솔 [연결 테스트] 통과 (capabilities 200 또는 404)

v1.1

• capabilities에 켠 기능의 엔드포인트가 모두 200 (켜지 않은 건 404여도 돼요)
• 같은 Idempotency-Key로 두 번 쓰면 두 번째는 실행 없이 같은 응답, 다른 본문이면 409 idempotency_conflict
• 배송중(N30) 주문 취소는 409 not_allowed_in_state, 출고 전은 200 + C00
• 남의 주문에 member_id를 넣어 쓰면 404
• 오류 본문은 { "error": { "code", "message" } }
• since_product_no 목록은 번호 오름차순, 숨김 상품 포함, 마지막 페이지는 limit보다 적게

[연결 테스트]는 /v1/capabilities만 확인해요. 주문·회원 응답 형식은 이 문서의 예시와 비교해 직접 확인해 주세요. 쓰기 점검은 꼭 시험 주문으로 해 주세요.