0 Choose a database name

Pick any name you want. Your own database will be created automatically on that name with the first request. In this documentation we'll call it my_database.

1 Create your first document

POST a JSON document to create a database. The database is created automatically on first request!

const response = await fetch('https://tinkr.tech/sdb/my_database', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'John', age: 25 })
});
const data = await response.json();
console.log(data); // {"id": "...", "name": "John", "age": 25}

2 Retrieve all documents

GET all documents from your database as a JSON array

async function getAll() {
	const response = await fetch('https://tinkr.tech/sdb/my_database');
	const documents = await response.json();
	console.log(documents); // Array of all documents
}

3 Update a document

PATCH a document by its ID to update it

const docId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://tinkr.tech/sdb/my_database/${docId}`, {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Jane', age: 26 })
});
const updated = await response.json();

4 Delete a document

DELETE a document by its ID

const docId = '550e8400-e29b-41d4-a716-446655440000';
await fetch(`https://tinkr.tech/sdb/my_database/${docId}`, {
  method: 'DELETE'
});

5 Polling for new documents

Use the since parameter to fetch only documents created after a specific ID

const lastId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://tinkr.tech/sdb/my_database?since=${lastId}`);
const newDocuments = await response.json();