Digital Item Connect 개요
Digital Item Connect는 DOSI 계정을 연동한 사용자가 파트너사 서비스의 상품을 DOSI 브랜드 스토어에서 거래할 수 있게 해주는 API입니다. Digital Item Connect API는 기본 기능과 디지털 아이템 기능, 사용자 간 거래(C2C) 아이템 기능으로 구성됩니다.
연결 정보
| 개발 환경 | DOSI SDK base URI |
|---|---|
| 운영 환경 | https://sdk-api.dosi.world |
응답 모델
Digital Item Connect는 HTTP 상태 코드와 API 응답 코드로 요청 처리 결과를 알려줍니다.
오류 응답
HTTP 상태 코드별 상세 오류 정보는 응답 본문(body)에 다음 형태로 반환합니다.
{
"responseCode": "<code>",
"errorMessage": "<message>"
}
아래 표에서 responseCode 상세 정보를 확인하세요.
errorMessage는 API 실행 결과에서 확인할 수 있습니다.
| HTTP 상태 코드 | API 응답 코드 | 설명 |
|---|---|---|
| 400 | BAD_REQUEST | 값을 잘못 입력했거나 요청한 자산 또는 사용자가 올바르지 않음 |
| 401 | NO_AUTHORITY | 잘못된 contract ID로 요청함. 지정한 DOSI 채널이 해당 contract ID에 접근 권한 없음 |
| 404 | NOT_FOUND_RESOURCE | 리소스를 찾을 수 없음 |
| 412 | FAILED_PRECONDITION | 요청한 자산 또는 사용자의 상태가 현재 요청을 수행하기에 올바르지 않음 |
| 415 | UNSUPPORTED_MEDIA_TYPE | 미디어 유형이 올바르지 않음. 미디어 업로드 가이드 참고 |
| 500 | INTERNAL_SERVER_ERROR | 알 수 없는 오류 |
| 503 | SERVICE_UNAVAILABLE | 서비스가 일시적으로 작동하지 않음 |
| 503 | MAINTENANCE | 유지보수 중이므로 요청을 처리할 수 없음 |