---
title: "Points de terminaison de l’API REST | Tajo"
description: "Documentation des points de terminaison de l’API REST"
url: https://tajo.io/fr/docs/endpoints/rest-api/
markdown: https://tajo.io/fr/docs/endpoints/rest-api.md
lang: fr-FR
author: "Set Noa"
author_url: https://tajo.io/fr/set-noa/
robots: noindex
---

Demandez un accès anticipé

Indiquez votre prénom et votre adresse e-mail professionnelle. Nous vous enverrons un lien pour confirmer votre demande d’accès à Tajo.

# Points de terminaison de l’API REST

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

Caution

**Page de démonstration** - Cette page de démonstration illustre la fonctionnalité de documentation multi-onglets. Ce contenu est fourni à titre d’illustration uniquement.

Notre API REST fournit des points de terminaison pour accéder aux données et les manipuler. Tous les points de terminaison renvoient les données au format JSON.

## URL de base

Toutes les requêtes API doivent être envoyées à l’URL de base suivante :

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

## Points de terminaison des utilisateurs

### Récupérer tous les utilisateurs

```http
GET /users
```

Renvoie la liste de tous les utilisateurs. Prend en charge les paramètres de pagination.

**Paramètres de requête :**

| Paramètre | Type | Description |
| --- | --- | --- |
| page | integer | Numéro de page (par défaut : 1) |
| limit | integer | Nombre d’enregistrements par page (par défaut : 50, max : 100) |
| sort | string | Champ servant au tri (par exemple « name », « created\_at ») |

**Réponse :**

```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
  }
}
```

### Récupérer un utilisateur par ID

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

Renvoie un utilisateur unique à partir de son ID.

**Réponse :**

```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"
    }
  }
}
```

## Points de terminaison des produits

### Récupérer tous les produits

```http
GET /products
```

Renvoie la liste de tous les produits. Prend en charge le filtrage et la pagination.

**Paramètres de requête :**

| Paramètre | Type | Description |
| --- | --- | --- |
| category | string | Filtrer par catégorie |
| min\_price | number | Filtrer par prix minimum |
| max\_price | number | Filtrer par prix maximum |
| page | integer | Numéro de page (par défaut : 1) |
| limit | integer | Nombre d’enregistrements par page (par défaut : 50, max : 100) |

**Réponse :**

```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
  }
}
```

## Gestion des erreurs

Tous les points de terminaison respectent les codes de statut HTTP standard et incluent des messages d’erreur détaillés lorsque cela est pertinent :

| Code de statut | Description |
| --- | --- |
| 200 | OK - La requête a abouti |
| 400 | Bad Request - Paramètres non valides |
| 401 | Unauthorized - Authentification requise |
| 403 | Forbidden - Permissions insuffisantes |
| 404 | Not Found - La ressource n’existe pas |
| 429 | Too Many Requests - Limite de débit dépassée |
| 500 | Internal Server Error - Une erreur serveur s’est produite |

Les réponses d’erreur incluent un message expliquant la nature du problème :

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