Skip to content

Error Code

JeongHyeon Kim edited this page Nov 30, 2025 · 1 revision

πŸŸ₯ 곡톡 μ˜ˆμ™Έ 응닡 ꡬ쑰 (RFC 9457 기반)

{
  "type": "https://your-domain.com/problem/{error-id}",
  "title": "{짧은 였λ₯˜ μš”μ•½}",
  "status": {HTTP μƒνƒœ μ½”λ“œ},
  "detail": "{상세 λ©”μ‹œμ§€}",
  "instance": "{μš”μ²­ν•œ API 경둜}",
  
  "errorCode": "{μ„œλΉ„μŠ€ λ‚΄λΆ€ λΉ„μ¦ˆλ‹ˆμŠ€ μ½”λ“œ}"  // ν™•μž₯ ν•„λ“œ
}

μ˜ˆμ‹œ 응닡

{
  "type": "https://example.com/errors/user-not-found",
  "title": "USER_NOT_FOUND",
  "status": 404,
  "detail": "μš”μ²­ν•œ ID의 μ‚¬μš©μžλ₯Ό 찾을 수 μ—†μŠ΅λ‹ˆλ‹€.",
  "instance": "/api/v1/users/123",
  "errorCode": "U001" 
}

Description

  • type : λ¬Έμ„œν™”λœ 였λ₯˜ μ‹λ³„μž URL
  • title : 짧은 였λ₯˜ 제λͺ©
  • status : HTTP Status Code
  • detail : 문제 상세 λ©”μ‹œμ§€
  • instance : 였λ₯˜κ°€ λ°œμƒν•œ API 경둜
  • errorCode : μ„œλΉ„μŠ€ λ‚΄λΆ€ λΉ„μ¦ˆλ‹ˆμŠ€ μ½”λ“œ (μ»€μŠ€ν…€ μ½”λ“œ 적용)

❗ Error Response

HTTP type errorCode μ„€λͺ…
404 /problem/user-not-found U001 USER_NOT_FOUND
400 /problem/invalid-request C001 INVALID_REQUEST_ERROR

Clone this wiki locally