jsonendpoint.com
A simple JSON endpoint API that supports GET
, POST
, PUT
, and DELETE
operations.
Feel free to use it for hobby and open source projects (that's what I do).
Powered by Cloudflare Workers and KV storage.
API
Anyone can read, write, and delete JSON data from any endpoint, there is no authentication or authorization. It's encouraged that you make part of the pathname unique to avoid collisions.
The URL pathname is used as the key in the key-value store. The key is case sensitive and trailing slashes are not ignored.
The endpoints in the docs below contains a uniquely generated slug that you can use to test with.
GET
– Read data
To read data from an endpoint use any HTTP client to issue a GET
request.
$ curl https://jsonendpoint.com/my-unique/endpoint/ // 200 response if data is found at the endpoint: → { "value": 42 } // 404 response if no data has been written to the endpoint: → { "message": "Not Found" }
POST
/ PUT
– Write data
To write data to an endpoint you must issue a POST
or PUT
request.
Upon a successful write, the API will return an empty JSON response with http code 200.
Any data that already exists at the endpoint will be overwritten.
$ curl https://jsonendpoint.com/my-unique/endpoint/ \
--request POST \
--data '{ "value": 42 }'
// 200 response if the write was successful:
→ {}
DELETE
– Delete data
To delete data at an endpoint you must issue a DELETE
request.
Upon successful deletion, the API will return an empty JSON response with http code 200.
The delete operation will still succeed even if no data exists at the endpoint.
$ curl https://jsonendpoint.com/my-unique/endpoint/ \
--request DELETE
// 200 response if the deletion was successful:
→ {}
Errors
If an error occurs, for example if you fail to provide a valid JSON payload for the POST
or PUT
operations, the request
will fail with http code 400 bad request:
$ curl https://jsonendpoint.com/my-unique/endpoint/ \
--request POST
// 400 if json payload is missing or invalid:
→ { "message": "Bad Request" }
Want to self-host?
You can create your own version of jsonendpoint.com by using the open source code available at github.com/henrikhaugboelle/jsonendpoint. Follow the instructions in the repository to get your own simple JSON endpoint API up and running.
Built by henrik.dev in Copenhagen, Denmark 2022