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