---
title: "Endpointuri REST API | Tajo"
description: "Documentație pentru endpointurile REST API"
url: https://tajo.io/ro/docs/endpoints/rest-api/
markdown: https://tajo.io/ro/docs/endpoints/rest-api.md
lang: ro-RO
author: "Set Noa"
author_url: https://tajo.io/ro/set-noa/
robots: noindex
---

Solicită acces anticipat

Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo.

# Endpointuri REST API

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

Caution

**Pagină demonstrativă** - Aceasta este o pagină demonstrativă care prezintă funcționalitatea de documentație cu mai multe file. Conținutul are doar scop ilustrativ.

REST API-ul nostru pune la dispoziție endpointuri pentru accesarea și modificarea datelor. Toate endpointurile returnează datele în format JSON.

## URL de bază

Trimite toate cererile către API la următorul URL de bază:

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

## Endpointuri pentru utilizatori

### Obține toți utilizatorii

```http
GET /users
```

Returnează lista tuturor utilizatorilor. Acceptă parametri de paginare.

**Parametri de interogare:**

| Parametru | Tip | Descriere |
| --- | --- | --- |
| page | integer | Numărul paginii (implicit: 1) |
| limit | integer | Numărul de înregistrări pe pagină (implicit: 50, maxim: 100) |
| sort | string | Câmpul după care se face sortarea (de exemplu, “name”, “created\_at”) |

**Răspuns:**

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

### Obține un utilizator după ID

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

Returnează un singur utilizator după ID.

**Răspuns:**

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

## Endpointuri pentru produse

### Obține toate produsele

```http
GET /products
```

Returnează lista tuturor produselor. Acceptă filtrare și paginare.

**Parametri de interogare:**

| Parametru | Tip | Descriere |
| --- | --- | --- |
| category | string | Filtrare după categorie |
| min\_price | number | Filtrare după prețul minim |
| max\_price | number | Filtrare după prețul maxim |
| page | integer | Numărul paginii (implicit: 1) |
| limit | integer | Numărul de înregistrări pe pagină (implicit: 50, maxim: 100) |

**Răspuns:**

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

## Tratarea erorilor

Toate endpointurile respectă codurile de stare HTTP standard și includ mesaje de eroare detaliate atunci când este cazul:

| Cod de stare | Descriere |
| --- | --- |
| 200 | OK - cererea a reușit |
| 400 | Bad Request - parametri invalizi |
| 401 | Unauthorized - este necesară autentificarea |
| 403 | Forbidden - permisiuni insuficiente |
| 404 | Not Found - resursa nu există |
| 429 | Too Many Requests - limita de cereri a fost depășită |
| 500 | Internal Server Error - a apărut o eroare pe server |

Răspunsurile de eroare includ un mesaj care explică ce a mers greșit:

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