Skip to main content

Endpoint Documentation

Please make sure you're using these endpoints respecting our usage guidelines.

Current Endpoint URL

All URLs provided below follow this protocol and hostname.
https://smponline-api.callmecarson.live

General

GET /

Returns a status report on the APIs. Status code 200 will always be returned unless the server is down. If the server is down, you will receive some sort of error code (5xx) from Cloudflare. The format of this is subject to change at any time and should be considered informational.

Chest Shops

GET /api/quickshop/v1/getAllShops

Returns 500 error and JSON Object if an error occurred. Possible errors are

  • {"error":"NOT_CACHED"}
  • {"error":"INTERNAL_ERROR"}

Returns 200 if valid. Result data is a JSON Array of shop data.

Note that SNBT data is only returned for items with enchantments, paintings, and potions.
Below is an example of valid data. 

{
   
    "id": 439,
        "owner": {
       
        "name": "_AdamGolden_",
       
        "uuid": "a66ac146-c6cd-40e3-b3be-3d21735a2480"
        },
   
    "location": {
                "x": 8317,
       
        "y": 64,
                "z": 9444,
       
        "world": "world"
        },
   
    "type": "SELLING",
        "price": 2,
   
    "remainingStock": 9,
        "item": {
       
        "type": "PAINTING",
                "quantity": 1,
       
        "name": "[Joy of Painting] Canvas (LONG)",
       
        "snbt": "{\"minecraft:custom_data\":{PublicBukkitValues:{\"smponline:canvas_author_uuid\":\"a66ac146-c6cd-40e3-b3be-3d21735a2480\",\"smponline:xerca_item\":\"xercapaint:item_canvas_long\",\"xercapaint:canvas_author\":\"_AdamGolden_\",\"xercapaint:canvas_generation\":3,\"xercapaint:canvas_id\":\"a66ac146-c6cd-40e3-b3be-3d21735a2480_1751403978\",\"xercapaint:canvas_title\":\"The Werner Wide\",\"xercapaint:canvas_version\":199}},\"minecraft:custom_model_data\":{strings:[\"xercapaint:item_canvas_long\"]},\"minecraft:item_name\":'{\"color\":\"red\",\"fallback\":\"[Joy of Painting] Canvas (LONG)\",\"italic\":false,\"translate\":\"item.xercapaint.item_canvas_long\"}',\"minecraft:max_stack_size\":1}"
        }
}