[중요] API Path 형식 및 오류 처리 방식 점검 안내

안녕하세요. 업비트 개발자센터입니다.

업비트 API 요청 시 개발자 문서에 안내된 Path 형식을 준수해 주시기 바랍니다. 지정된 형식과 다른 Path로 요청하는 경우 오류가 반환될 예정입니다.

또한 현재 error.message를 기준으로 API 오류를 처리하고 계신 경우, error.name을 기준으로 처리하도록 변경해 주시기 바랍니다.

API 이용에 영향이 발생하지 않도록 적용일 이전에 요청 Path 및 오류 응답 처리 방식을 점검하고 필요한 경우 수정해 주시길 바랍니다.

1.적용 일시

• 적용 예정일: 2026-11-16 (월)

2.주요 내용

1) API 요청 Path 형식 준수

API 요청 Path는 다음 형식을 준수해야 합니다.

• Path 시작 및 중간: 경로 구분자로 / 1개만 허용
• Path 끝: / 사용 불가

정상 요청 Path

/v1/orders

오류 반환 대상 Path

//v1/orders
/v1//orders
/v1/orders//

적용일 이후 위와 같이 불필요한 슬래시(/)가 포함된 Path로 요청하는 경우 오류가 반환됩니다.

2) API 오류 응답 처리 기준

error.message는 안내 문구가 변경될 수 있으므로, 현재 error.message를 기준으로 API 오류를 식별하거나 처리하고 계신 경우 error.name을 기준으로 오류를 식별하고 처리해 주시기 바랍니다.

{
  "error": {
    "name": "ERROR_CODE", 
    "message": "ERROR_MESSAGE" → 비권장
  }
}

3.적용 전 확인 사항

현재 사용 중인 API 연동 환경에서 다음 사항을 확인해 주세요.

• Path 시작과 중간에 슬래시(/)가 중복되거나 마지막에 포함되어 있지 않은지
• BASE_URL과 PATH 결합 시 슬래시(/)가 중복되지 않는지
• API 오류 응답을 error.name 기준으로 처리하고 있는지

예를 들어 다음과 같이 URL을 구성하면 슬래시가 중복될 수 있습니다.

4.유의사항

• 적용일 이후 Path 형식 미준수로 인해 API 요청이 실패할 수 있으므로 사전에 점검 및 테스트를 진행해 주세요.
• 적용 일정은 운영 상황에 따라 변경될 수 있으며, 변경 시 본 공지를 통해 다시 안내드리겠습니다.

원활한 API 이용을 위해 적용일 이전에 요청 Path와 오류 응답 처리 로직을 확인해 주시기 바랍니다.

문의 사항은 [email protected]으로 연락해 주시기 바랍니다.

감사합니다.
업비트 개발자센터 드림