Back to articles

Free API Guide

A detailed guide to Free API: create records, read data, work with FIFO, and use query parameters.

5 min read

Free API is a REST API that lets you immediately create, read, update, and delete your own JSON records without creating collections first.

It is useful for frontend projects when you need the fastest possible start: demos, interview tasks, learning projects, prototypes, and small pet projects.

You send JSON to the API and immediately get a ready-to-use record with an id.

Each response follows the JSend format.

Limits and behavior#

All data in Free API is tied to your account, so the Authorization header is required for every request.

Free API supports up to 30 records at the same time.

Each record can be any JSON object as long as it does not exceed 5 KB.

The rate limit is 100 requests per minute.

How FIFO works#

The main feature of Free API is automatic FIFO behavior.

If you add a new record after reaching the 30 record limit, the oldest record is removed automatically and the new one is stored instead.

This is convenient when you do not want to manually monitor the number of stored records and delete old ones yourself.

Create your first record#

To create a record, send a POST request to:

Example request:

Example response:

Where:

  • id — unique record identifier
  • payload — your JSON object
  • createdAt — record creation time
  • updatedAt — last update time

Get a single record#

If you need one specific record, use its id:

Example request:

Example response:

Get the record list#

To read all available records, send a GET request to:

Example request:

Example response:

You can inspect rate limits in the response headers.

Example headers:

Query parameters#

Free API supports query parameters for more convenient list handling.

They are especially useful for tables, lists, pagination, and sorting in the UI.

Available parameters:

  • page — page number
  • limit — number of records in the response
  • sort — sorting by record id. Available values: ASC and DESC

Example request:

Update a record#

To update a record, use a PATCH request:

Important: Free API fully overwrites the object. If you want to change only one field, you still need to send the other fields in their current state.

Example request:

Delete a record#

To delete a record, use a DELETE request:

Example request:

If the deletion is successful, the API returns 204 No Content.

Playground#

Free API includes a built-in Playground where you can quickly send requests directly from the browser.

This is useful for testing, checking your data structure, and debugging without a separate client.

Open Free API