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	Required
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>

Request examples

curl

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

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.

Response status code

200 OK

Response headers

None

Related errors

• NOT_FOUND_RESOURCE

Response examples

{
    "sales": [
        {
            "saleId": 1234,
            "itemType": "10000001",
            "itemIndex": "00000001",
            "name": "item name",
            "currency": "USD",
            "price": "1.2"
        }
    ],
    "nextPageToken": null
}

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.

Query

None

Body

None

Headers

• Authorization: Basic <Base64-encoded 'DOSI channel ID:secret>

Request examples

curl

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

None

Response status code

202 Accepted

Response headers

None

Related errors

• NOT_FOUND_RESOURCE

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.

Query

None

Body

None

Headers

• Authorization: Basic <Base64-encoded 'DOSI channel ID:secret>

Request examples

curl

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

Name	Type	Description	Included
status	string	Sale cancellation status. One of the followings: "NONE": No record for sale cancellation "PENDING": Sale cancellation underway "FAILED": Sale cancellation failed "COMPLETED": Sale cancellation completed

Response status code

200 OK

Response headers

None

Related errors

• NOT_FOUND_RESOURCE

Response examples

{
    "status": "COMPLETED"
}