Open API 변경사항 안내 (4/23 11:00 적용완료)

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

본 공지를 통하여 Open API 변경 사항 및 적용 일정을 안내 드립니다.

[EXCHANGE API 변경사항 및 적용 일정 안내]

[EXCHANGE API 변경사항 안내]

인증 방식 변경 없이 지원하는 API

JWT 토큰 Payload nonce에 UUID 지원
. 기존 JWT 토큰의 nonce로 epoch 밀리초를 받고 있었으나, 짧은 시간에 다량의 요청을 보내는 경우 nonce 중복 에러가 발생하는 문제가 있었습니다.
. 이를 해결하기 위해 nonce에 timestamp 외에 무작위 UUID 값을 넣어 요청할 수 있는 기능을 추가 지원합니다.
. 별도의 추가 파라미터 없이, 기존의 nonce에 무작위 UUID 문자열을 넣어 요청하면 됩니다.
바로출금 기능 지원
. 업비트의 바로출금 기능을 지원합니다.
. 출금하기 API (POST /withdraws/coin) 에 transaction_type 파라미터 추가를 추가합니다.
: 유효한 값 : default | internal
: 업비트 회원의 주소가 아닌 주소로 바로출금을 요청하는 경우, 출금이 정상적으로 수행되지 않습니다.
. 입금, 출금과 관련한 API 응답에 transaction_type 필드를 추가합니다.

인증 방식 변경이 필요한 API

인증 방식 추가
. 본 업데이트를 통해 쿼리 파라미터를 배열 형태로 복수로 추가하는 기능이 추가됩니다.
. 이때 쿼리가 길어질 경우, JWT 토큰 길이도 함께 길어지며 이에 따라 일부 네트워크 환경에서는 토큰의 뒷부분이 잘리는 문제가 발생할 수 있습니다.
. 이러한 문제를 막기 위해 Open API에서는 쿼리 해싱을 통한 JWT 토큰 생성 방식을 추가 지원합니다.
. JWT Payload의 query 필드를 query_hash, query_hash_alg 필드로 대체합니다.
: query_hash_alg > 쿼리 스트링을 해싱한 알고리즘을 명시 (기본값 : SHA512)
: query_hash > 쿼리 스트링을 해싱한 값 명시
*기존의 쿼리 전체를 보내는 방식은 유효하지만, 상기 안내와 같이 토큰의 손실이 발생할 수 있으므로 해싱을 통한 인증 방식의 이용을 권장합니다.
주문 복수 조회 기능 추가
. 주문 리스트 조회 API(GET /orders)에 uuids, identifiers 파라미터를 추가합니다.
: uuids 는 주문 UUID 목록을 의미합니다.
: identifiers 는 사용자가 주문 생성 시 작성한 식별자 목록을 의미합니다.
. 위 두 파라미터와 기존의 파라미터들은 모두 AND 조건으로 동작합니다. 예를 들어 uuids 파라미터와 함께 status=wait 을 요청한 경우, 해당하는 UUID 중 대기 상태인 주문 목록을 응답합니다.
. Array 요청 형식은 다음과 같습니다.
: UUID가 xxx, yyy, zzz인 세 개의 주문을 조회하는 경우의 예시 : uuids[]=xxx&uuids[]=yyy&uuids[]=zzz
: 요청 순서와 응답 순서의 동일성은 보장하지 않습니다. 예를 들어 위 요청의 응답이 zzz, xxx, yyy 등의 순서로 오는 것도 가능합니다.

[변경 사항 적용 일정 안내]

. 2019-04-23(화) 11:00 이후 적용 예정
*본 작업은 Open API 서비스 이용에 영향을 주지 않습니다. 이용에 참고 부탁드립니다.

Open API를 이용하여 응용프로그램을 개발 중이신 회원님들께서는 상기 Open API 변경사항을 참고해주시기 바랍니다.
관련하여 문의사항 있으시면 [email protected]으로 문의주시면 빠른 시일 내에 답변 드리도록 하겠습니다.

언제나 최선을 다하는 업비트가 되겠습니다.

감사합니다.