Thingies API

Probably the simplest API in the world.

Introduction

The simplest API deserves the simplest Developer Portal made with just a single page.

API Documentation

Create a thingy.

This API endpoint allows you to create a thingy.

POST /thingies
{
  "name": "firstName",
  "value": "Patrice"
}
201 The `thingy` has been successfully created.
{
  "id": "fda311ae-aa62-43e9-92b5-6e4e92f40044"
  "name": "firstName",
  "value": "Patrice"
}

Sample code with curl

curl -X POST https://api.thingies.io/thingies -H "Content-Type: application/json" \
  -d "{\"name\": \"firstName\", \"value\": \"Patrice\"}"

List all thingies.

This API endpoint gives you the list of all thingies (without pagination).

GET /thingies
200 OK
[
  {
    "id": "fda311ae-aa62-43e9-92b5-6e4e92f40044"
    "name": "firstName",
    "value": "Patrice"
  },
  {
    "id": "ec2142da-09de-4961-9449-f290e07f202e"
    "name": "countrty",
    "value": "Belgium"
   }
]
404 There are no `thingies`.

Sample code with curl

curl -X GET https://api.thingies.io/thingies

Get the details of a specific thingy

This API endpoint gives you the details of a specific thingy.

GET /thingies/{thingyId}
GET /thingies/fda311ae-aa62-43e9-92b5-6e4e92f40044
200 OK
{
  "id": "fda311ae-aa62-43e9-92b5-6e4e92f40044"
  "name": "firstName",
  "value": "Patrice"
}
GET /thingies/99999999-9999-9999-9999-999999999999
404 The specified `thingy` does not exist.

Sample code with curl

curl -X GET https://api.thingies.io/thingies/fda311ae-aa62-43e9-92b5-6e4e92f40044

Delete a specific thingy

This API endpoint allows you to delete a specific thingy.

DELETE /thingies/{thingyId}
DELETE /thingies/fda311ae-aa62-43e9-92b5-6e4e92f40044
204 The specified `thingy`, if it existed, has been deleted.

Sample code with curl

curl -X DELETE https://api.thingies.io/thingies/fda311ae-aa62-43e9-92b5-6e4e92f40044

OpenAPI Document

You can also download the OpenAPI documentation of the Thingies API: