[핏] FitProduct API 에러 원인과 해결 방법

핵심 요약

• 401은 인증 문제(토큰 누락/만료)로 발생하며, 토큰 재발급이 필요합니다.
• 400 계열은 파라미터 오류(범위/형식/지원되지 않는 옵션명)로, 입력 값 검증이 우선입니다.
• 404는 대상 자원이 없을 때 발생하며, 상품/실측/브랜드 존재 여부를 확인합니다.
• 에러 메시지에 힌트가 포함됩니다. 메시지를 기준으로 해당 항목만 수정해 재요청하면 빠르게 해결됩니다.

에러 코드 목록

401 Unauthorized

• http status : 401 Unauthorized
• code : —
• message : —
• description : 인증 토큰이 없거나 유효하지 않은 토큰입니다.
• what to do : 토큰을 재발급하고 헤더에 정상 포함해 다시 요청합니다.

400 Bad Request – Invalid parameters

• http status : 400 Bad Request
• code : 4001000
• message : Invalid parameters
• description :
  • limit 값이 1~100 범위를 벗어난 경우
  • page 값이 1~total page 범위를 벗어난 경우
• what to do : 요청 파라미터의 범위를 점검하고 유효한 값으로 수정합니다.

404 Not Found – JSON parse error

• http status : 404 Not Found
• code : 4002000
• message : JSON parse error
• description :
  • JSON 파라미터 형식 오류
  • sizes, infos, properties는 JSON 형식의 문자열을 입력받으며, 유효하지 않은 형식 전달 시 오류 발생
• what to do : JSON 유효성 검사 후 올바른 형식으로 재요청합니다.

404 Not Found – 상품 not found: code:

• http status : 404 Not Found
• code : 4041000
• message : 상품 not found: code:
• description : 해당 code의 상품이 존재하지 않습니다. 상품 생성 이후에만 Fit product 생성이 가능합니다.
• what to do : 요청한 code의 상품이 크리마 DB에 존재하는지 확인합니다.

404 Not Found – Fit product not found: id:

• http status : 404 Not Found
• code : 4041000
• message : Fit product not found: id:
• description :
  • code 파라미터를 보냈고 상품은 존재하지만, 해당 상품에 실측(Fit product)이 아직 없음
  • id 파라미터를 보냈으나 해당 실측(Fit product)이 없음
• what to do : 대상 상품/실측 존재 여부를 확인한 뒤 올바른 code 또는 id로 요청합니다.

404 Not Found – 쇼핑몰 not found: brand_id:

• http status : 404 Not Found
• code : 4041000
• message : 쇼핑몰 not found: brand_id:
• description :
  • 브랜드(쇼핑몰)을 찾을 수 없습니다.
  • 인증 토큰으로 쇼핑몰을 식별하므로 일반적으로 brand_id 없이도 요청 가능합니다.
• what to do : brand_id를 지정하지 않았는데도 오류가 발생하면 크리마에 문의합니다.

400 Bad Request – Fit template 연결 필요

• http status : 400 Bad Request
• code : 4003000
• message : Failed to create 실측 치수. reasons: Fit template should be connected first with the category of this product
• description : 상품의 카테고리와 Fit 템플릿이 연결되어 있지 않습니다.
• what to do : 해당 상품 카테고리에 Fit 템플릿이 연결되어 있는지 확인합니다. (경로: 크리마 관리자 페이지 → 핏 → 핏 설정 → FitProductAPI 설정)

400 Bad Request – Fit Category 연결 필요

• http status : 400 Bad Request
• code : 4003000
• message : Failed to create 실측 치수. reason: Fit Category should be connected first with the category of this product.
• description : 상품의 카테고리와 Fit 카테고리가 연결되어 있지 않습니다.
• what to do : 해당 상품 카테고리에 알맞은 Fit 카테고리/템플릿 연결 상태를 확인합니다. (경로: 크리마 관리자 페이지 → 핏 → 핏 설정 → FitProductAPI 설정)

400 Bad Request – 지원되지 않는 옵션명 포함

• http status : 400 Bad Request
• code : 4001102
• message : Failed to create or update Fit product. reason: 'OPTION_KEY_NAME' is not supported.
• description : Fit 템플릿에서 사용하지 않는 옵션명이 포함되어 전체 생성/수정 요청이 실패했습니다.
• what to do : 에러 메시지에 표시된 지원되지 않는 항목을 제외하고, 상품에 연결된 Fit 템플릿의 실측치수/상품정보/상품속성 항목 목록을 확인해 재구성합니다.

자주 묻는 질문 (FAQ)

위에 없는 오류가 발생하면 어떻게 해야 하나요?

👉 문서에 없는 오류 코드나 예외 응답이 발생한 경우, 아래 두 가지 정보를 함께 정리하여 크리마 핏 운영팀(fit@cre.ma)으로 보내주세요.

• 요청 URL 전문 (API Endpoint 포함)
• 요청 시각 (YYYY-MM-DD HH:MM 형식)

운영팀이 서버 로그를 통해 빠르게 원인을 분석하고 안내드립니다.

JSON 파라미터를 문자열로 보낼 때 가장 흔한 오류는 무엇인가요?

👉 sizes, infos, properties를 JSON 문자열로 보낼 때 따옴표 이스케이프 누락과 배열/객체 괄호 불일치가 가장 흔합니다. 전송 전 JSON Validator로 검증해 주세요.