---
title: "REST API-endpoints | Tajo"
description: "Documentatie over de REST API-endpoints"
url: https://tajo.io/nl/docs/endpoints/rest-api/
markdown: https://tajo.io/nl/docs/endpoints/rest-api.md
lang: nl-NL
author: "Set Noa"
author_url: https://tajo.io/nl/set-noa/
robots: noindex
---

Vraag vroegtijdige toegang aan

Vul je voornaam en je zakelijke e-mailadres in. We sturen je een link om je aanvraag voor toegang tot Tajo te bevestigen.

# REST API-endpoints

[Set Noa](https://tajo.io/nl/set-noa/)

Caution

**Demopagina** - Dit is een demopagina die de documentatiefunctie met meerdere tabbladen laat zien. Deze inhoud dient alleen ter illustratie.

Onze REST API biedt endpoints om gegevens op te vragen en te bewerken. Alle endpoints geven gegevens terug in JSON-formaat.

## Basis-URL

Stuur alle API-verzoeken naar de volgende basis-URL:

```
https://api.example.com/v1
```

## Endpoints voor gebruikers

### Alle gebruikers ophalen

```http
GET /users
```

Geeft een lijst met alle gebruikers terug. Ondersteunt paginatieparameters.

**Queryparameters:**

| Parameter | Type | Beschrijving |
| --- | --- | --- |
| page | integer | Paginanummer (standaard: 1) |
| limit | integer | Aantal records per pagina (standaard: 50, max: 100) |
| sort | string | Veld om op te sorteren (bijvoorbeeld “name”, “created\_at”) |

**Reactie:**

```json
{
  "data": [
    {
      "id": "user_123",
      "name": "John Doe",
      "email": "john@example.com",
      "created_at": "2023-01-15T08:30:00Z"
    },
    // More users...
  ],
  "meta": {
    "total": 250,
    "page": 1,
    "limit": 50
  }
}
```

### Gebruiker ophalen op ID

```http
GET /users/{id}
```

Geeft één gebruiker terug op basis van de ID.

**Reactie:**

```json
{
  "data": {
    "id": "user_123",
    "name": "John Doe",
    "email": "john@example.com",
    "created_at": "2023-01-15T08:30:00Z",
    "profile": {
      "bio": "Software developer",
      "location": "New York",
      "avatar_url": "https://example.com/avatars/john.jpg"
    }
  }
}
```

## Endpoints voor producten

### Alle producten ophalen

```http
GET /products
```

Geeft een lijst met alle producten terug. Ondersteunt filteren en paginatie.

**Queryparameters:**

| Parameter | Type | Beschrijving |
| --- | --- | --- |
| category | string | Filter op categorie |
| min\_price | number | Filter op minimumprijs |
| max\_price | number | Filter op maximumprijs |
| page | integer | Paginanummer (standaard: 1) |
| limit | integer | Aantal records per pagina (standaard: 50, max: 100) |

**Reactie:**

```json
{
  "data": [
    {
      "id": "prod_123",
      "name": "Example Product",
      "description": "This is an example product",
      "price": 49.99,
      "category": "electronics"
    },
    // More products...
  ],
  "meta": {
    "total": 350,
    "page": 1,
    "limit": 50
  }
}
```

## Foutafhandeling

Alle endpoints volgen de standaard HTTP-statuscodes en geven waar nodig gedetailleerde foutmeldingen terug:

| Statuscode | Beschrijving |
| --- | --- |
| 200 | OK - Het verzoek is geslaagd |
| 400 | Bad Request - Ongeldige parameters |
| 401 | Unauthorized - Authenticatie vereist |
| 403 | Forbidden - Onvoldoende rechten |
| 404 | Not Found - De resource bestaat niet |
| 429 | Too Many Requests - Snelheidslimiet overschreden |
| 500 | Internal Server Error - Er is een serverfout opgetreden |

Foutreacties bevatten een bericht dat uitlegt wat er misging:

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'email' is not a valid email address",
    "request_id": "req_abc123"
  }
}
```