사용자 간 거래(C2C) 아이템
사용자 간 거래 아이템 기능은 사용자가 DOSI 브랜드 스토어에서 판매 등록한 디지털 아이템 목록을 조회하고, 파트너사 서비스에서 판매 취소할 수 있는 엔드포인트 묶음입니다.
사용자가 판매 등록한 디지털 아이템을 조회하고 취소하려면 먼저 프록시(Proxy)를 설정해야 합니다.
연결 정보
| 개발 환경 | DOSI SDK base URI |
|---|---|
| 운영 환경 | https://sdk-api.dosi.world |
사용자가 판매 중인 디지털 아이템 조회
사용자가 직접 DOSI 브랜드 스토어에서 판매 중인 디지털 아이템을 조회합니다.
프록시(proxy)를 승인한 사용자 계정에서만 사용할 수 있습니다.
Path
None
Query
Name | Type | Description | Required |
|---|---|---|---|
contractId | string | DOSI SDK 사용 신청 후 받은 contract ID. 요청 헤더 Authorization에 입력한 DOSI 채널과 연결된 contract ID만 입력해야 합니다. | |
walletAddress | string | 사용자 DOSI 계정의 월렛 주소 | |
pageSize | number | 한 페이지에 포함할 디지털 아이템 수
| |
pageToken | string | 페이지 시작 지점 토큰(이전 페이지 조회 응답의 |
Body
None
- Authorization: Basic <'DOSI 채널 ID:시크릿'을 Base64로 인코딩한 값>
Request examples
curl -v -X GET "https://sdk-api.dosi.world/v1/store/sales?contractId=9138939b&walletAddress=link1xyz" \
--header 'Authorization: Basic xxxx'
사용자가 판매 중인 디지털 아이템 판매 취소
사용자가 직접 DOSI 브랜드 스토어에서 판매 중인 상품을 판매 취소합니다. 이 엔드포인트를 사용해 파트너사 서비스에 판매 취소 기능을 구현할 수 있습니다.
프록시(proxy)를 승인한 사용자 계정에서만 사용할 수 있습니다.
Path
Name | Type | Description |
|---|---|---|
saleId | number | 판매 취소할 디지털 아이템의 sale ID. DOSI 브랜드 스토어에서 판매 등록할 때 발급받은 ID를 입력하세요.
|
Query
None
Body
None
- Authorization: Basic <'DOSI 채널 ID:시크릿'을 Base64로 인코딩한 값>
Request examples
curl -v -X DELETE "https://sdk-api.dosi.world/v1/store/sales/1234" \
--header 'Authorization: Basic xxxxxxxx'
판매 취소 상태 조회
사용자가 디지털 아이템 판매를 취소한 경우 취소 상태를 조회합니다.
Path
Name | Type | Description |
|---|---|---|
saleId | number | 조회할 디지털 아이템의 sale ID. DOSI 브랜드 스토어에서 판매 등록할 때 발급받은 ID를 입력하세요.
|
Query
None
Body
None
- Authorization: Basic <'DOSI 채널 ID:시크릿'을 Base64로 인코딩한 값>
Request examples
curl -v -X GET "https://sdk-api.dosi.world/v1/store/sales/1234/status" \
--header 'Authorization: Basic xxxx'