Version: 1.2.0-1.3.0

Consumer-to-consumer (C2C) items

The Consumer-to-Consumer (C2C) item functionality is a set of endpoints that enables partner services to view the list of digital items registered for sale by users in the DOSI Brand Store and to cancel those sales.

The proxy must have been set to get or cancel digital items registered for sales by users.

Connection info

Development environment	DOSI SDK base URI
Production	https://sdk-api.dosi.world

Get digital items on sale by user

Gets the digital item sales put on by a user in the DOSI Brand Store.

GET {DOSI SDK base URI}/v1/store/sales

This endpoint can only be used in user accounts that authorize a proxy.

Request

Response

Path

None

Query

Name	Type	Description
`contractId`	string	Contract ID received after applying for DOSI SDK. You can only use the contract ID linked to the DOSI channel provided for Authorization in the request header.
`walletAddress`	string	Wallet address of the user's DOSI account
`pageSize`	number	Number of digital items per page Default: 10 Minimum: 1 Maximum: 100
`pageToken`	string	Token for the start of the page (that is, `nextPageToken` in the response for the previous page). Starts from the first page if not provided.

Body

None

Headers

Authorization: Basic <Base64-encoded 'DOSI channel ID:secret>
Content-Type: application/json

Request examples

curl

curl -v -X GET "https://sdk-api.dosi.world/v1/store/sales?contractId=9138939b&walletAddress=link1xyz" \
  --header 'Authorization: Basic xxxx' \
  --header 'Content-Type: application/json'

Name	Type	Description	Included
`sales`	array	List of digital items on sale.
`nextPageToken`	string	Token for the start of the next page. Null if there is no next page.

Cancel digital item on sale by user

Cancels a digital item sale put on by users in the DOSI Brand Store. Partner services can use this endpoint to implement a feature for canceling sales.

DELETE {DOSI SDK base URI}/v1/store/sales/{saleId}

This endpoint can only be used in user accounts that approved the proxy only.

Request

Response

Path

Name	Type	Description
`saleId`	number	Sale ID of the digital item for cancellation. Provide the ID issued when registering for sale in the DOSI Brand Store. You can also get the sale ID with the Get digital items on sale by user endpoint.

Name

Type

Description

saleId

number

Sale ID of the digital item for cancellation. Provide the ID issued when registering for sale in the DOSI Brand Store.

You can also get the sale ID with the Get digital items on sale by user endpoint.

Query

None

Body

None

Headers

Authorization: Basic <Base64-encoded 'DOSI channel ID:secret>
Content-Type: application/json

Request examples

curl

curl -v -X DELETE "https://sdk-api.dosi.world/v1/store/sales/1234" \
  --header 'Authorization: Basic xxxxxxxx' \
  --header 'Content-Type: application/json'

Get sale cancellation status

Gets the cancellation status when users canceled a digital item sale.

GET {DOSI SDK base URI}/v1/store/sales/{saleId}/status

Request

Response

Path

Name	Type	Description
`saleId`	number	Sale ID of the digital item for retrieval. Provide the ID issued when registering for sale in the DOSI Brand Store. You can also get the sale ID with the Get digital items on sale by user endpoint.

Name

Type

Description

saleId

number

Sale ID of the digital item for retrieval. Provide the ID issued when registering for sale in the DOSI Brand Store.

You can also get the sale ID with the Get digital items on sale by user endpoint.

Query

None

Body

None

Headers

Authorization: Basic <Base64-encoded 'DOSI channel ID:secret>
Content-Type: application/json

Request examples

curl

curl -v -X GET "https://sdk-api.dosi.world/v1/store/sales/1234/status" \
  --header 'Authorization: Basic xxxx' \
  --header 'Content-Type: application/json'