Endpoints
/marketplace_advertise
Create a new listing in the UEX Marketplace
| Method | POST |
|---|---|
| URL | https://uexcorp.space/api/2.0/marketplace_advertise/ |
| Authorization | Bearer Token |
| Cache TTL | — |
| Input (Header) |
// required user secret key, should be passed via header, obtained in user profile secret_key string(40) |
| Input (POST) |
id_category int(11) // required operation string(4) // "buy", "sell", "trade" or "rent" type string(10) // required "item" or "service" unit string(40) // required (see reference down below) price int(11) // required, UEC title string(140) // required, alphanumeric and dashes only description string(65535) // required image_data string(10485760) // image in base64, up to 10.00 MB is_production int(1) // required for production |
|
JSON input example |
{ "is_production": 0, "id_category": 3, "operation": "sell", "type": "item", "unit": "unit", "price": 120000, "title": "Fieldsbury Dark Bear Helmet Pink", "description": "Be a bad boy with this beautiful helmet!", "image_data": "/9j/4AAQSkZJRgABAQAASABIAAD..." } |
| Output |
id_listing int(11) // listing unique ID url string(255) // new listing URL date_expiration int(11) // timestamp, listing expiration date |
| Responses |
// user secret key not provided missing_secret_key // user not found with provided secret key user_not_found // user banned or disabled by administrator user_not_allowed // user account not verified on RSI website user_not_verified // user secret key length should be exactly 40 characters invalid_secret_key // transaction type not provided missing_operation // invalid transaction type - should be buy or sell invalid_operation // listing type not provided missing_type // invalid listing type - should be item or service invalid_type // category ID not provided missing_id_category // category ID not found category_not_found // unit not provided missing_unit // invalid unit invalid_unit // listing title not provided missing_title // listing description not provided missing_description // if provided, image size exceeds limit of 10.00 MB image_data_exceeds_limit // reached limit of 100 listings per user user_active_listings_limit_reached // invalid file data image_upload_error // server image storage error image_storage_error // all good! ok |
| Operations (transactions) reference |
buy sell |
| Listing types reference |
item // inventory items such as helmets, armor sets, etc. service // in-game services such as escort, bodyguard, etc. |
| Units reference |
For type "item": box cscu dozen hundred pair scu thousand unit For type "service": day hour minute mission million mk month run trip week |
| Last update: | 2 months ago |
Optional Required Required as header input