ClickCrate
WebsiteSupportTwitter
  • Introduction
  • Overview
  • Quick Start
  • API Reference
    • Point of Sale (ClickCrate)
    • Product Listing
    • Orders
    • Credentials
    • Blinks
  • resources
    • Glossary
    • Common Issues
    • Need Help?
Powered by GitBook
On this page
  1. API Reference

Product Listing

Work with Product Listings

PreviousPoint of Sale (ClickCrate)NextOrders

Last updated 7 months ago

  • POSTFetch product listings owned by a user
  • POSTFetch a specific registered product listing
  • POSTFetch details of a specific product listing
  • POSTRegister a new ProductListing
  • PUTUpdate an existing ProductListing
  • POSTActivate a ProductListing
  • POSTDeactivate a ProductListing
  • POSTPlace a ProductListing in a ClickCrate
  • POSTRemove a ProductListing from a ClickCrate

Fetch product listings owned by a user

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
ownerstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Responses
200
200
application/json
500
500
application/json
post
POST /v1/product-listing/owned-listings HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "owner": "text"
}
{
  "productListings": [
    {
      "productListingId": "text",
      "origin": "clickcrate",
      "owner": "text",
      "manager": "text",
      "placementType": "digitalreplica",
      "productCategory": "clothing",
      "inStock": "text",
      "sold": "text",
      "clickcratePos": "text",
      "isActive": true,
      "price": 1,
      "vault": "text",
      "orderManager": "clickcrate"
    }
  ]
}

Fetch a specific registered product listing

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Responses
200
200
application/json
404
404
application/json
500
500
application/json
post
POST /v1/product-listing/registered HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "productListingId": "text"
}
{
  "productListingId": "text",
  "origin": "clickcrate",
  "owner": "text",
  "manager": "text",
  "placementType": "digitalreplica",
  "productCategory": "clothing",
  "inStock": "text",
  "sold": "text",
  "clickcratePos": "text",
  "isActive": true,
  "price": 1,
  "vault": "text",
  "orderManager": "clickcrate"
}

Fetch details of a specific product listing

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
networkstringRequired
Responses
200
200
application/json
404
404
application/json
500
500
application/json
post
POST /v1/product-listing/details HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "productListingId": "text",
  "network": "text"
}
{
  "collection": null
}

Register a new ProductListing

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
originstring · enumRequiredPossible values:
placementTypestring · enumRequiredPossible values:
productCategorystring · enumRequiredPossible values:
managerstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
priceintegerRequired
orderManagerstring · enumRequiredPossible values:
Responses
200
200
application/json
400
400
application/json
409
409
application/json
post
POST /v1/product-listing/register HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 166

{
  "productListingId": "text",
  "origin": "clickcrate",
  "placementType": "digitalreplica",
  "productCategory": "clothing",
  "manager": "text",
  "price": 1,
  "orderManager": "clickcrate"
}
{
  "message": "text",
  "transaction": "text"
}

Update an existing ProductListing

put
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
placementTypestring · enumRequiredPossible values:
productCategorystring · enumRequiredPossible values:
managerstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
priceintegerRequired
Responses
200
200
application/json
400
400
application/json
404
404
application/json
put
PUT /v1/product-listing/update HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "productListingId": "text",
  "placementType": "digitalreplica",
  "productCategory": "clothing",
  "manager": "text",
  "price": 1
}
{
  "message": "text",
  "transaction": "text"
}

Activate a ProductListing

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Responses
200
200
application/json
404
404
application/json
post
POST /v1/product-listing/activate HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "productListingId": "text"
}
{
  "message": "text",
  "transaction": "text"
}

Deactivate a ProductListing

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Responses
200
200
application/json
404
404
application/json
post
POST /v1/product-listing/deactivate HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "productListingId": "text"
}
{
  "message": "text",
  "transaction": "text"
}

Place a ProductListing in a ClickCrate

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
clickcrateIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
pricenumberRequired
Responses
200
200
application/json
400
400
application/json
post
POST /v1/product-listing/place HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "productListingId": "text",
  "clickcrateId": "text",
  "price": 1
}
{
  "message": "text",
  "transactions": [
    "text"
  ]
}

Remove a ProductListing from a ClickCrate

post
Authorizations
Header parameters
authorizationstringRequiredExample: Bearer <YOUR_API_KEY>
Body
productListingIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
clickcrateIdstringRequiredPattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Responses
200
200
application/json
404
404
application/json
post
POST /v1/product-listing/remove HTTP/1.1
Host: api.clickcrate.xyz
Authorization: Bearer API key
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "productListingId": "text",
  "clickcrateId": "text"
}
{
  "message": "text",
  "transaction": "text"
}