---
title: "Punkty końcowe REST API | Tajo"
description: "Dokumentacja punktów końcowych REST API"
url: https://tajo.io/pl/docs/endpoints/rest-api/
markdown: https://tajo.io/pl/docs/endpoints/rest-api.md
lang: pl-PL
author: "Set Noa"
author_url: https://tajo.io/pl/set-noa/
robots: noindex
---

Poproś o wcześniejszy dostęp

Podaj imię i firmowy adres e-mail. Wyślemy Ci link potwierdzający prośbę o dostęp do Tajo.

# Punkty końcowe REST API

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

Caution

**Strona demonstracyjna**, to strona pokazowa prezentująca funkcję dokumentacji z wieloma zakładkami. Ta treść ma charakter wyłącznie poglądowy.

Nasze REST API udostępnia punkty końcowe do odczytu i modyfikacji danych. Wszystkie punkty końcowe zwracają dane w formacie JSON.

## Bazowy URL

Wszystkie żądania do API kieruj na następujący bazowy URL:

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

## Punkty końcowe użytkowników

### Pobierz wszystkich użytkowników

```http
GET /users
```

Zwraca listę wszystkich użytkowników. Obsługuje parametry paginacji.

**Parametry zapytania:**

| Parametr | Typ | Opis |
| --- | --- | --- |
| page | integer | Numer strony (domyślnie: 1) |
| limit | integer | Liczba rekordów na stronę (domyślnie: 50, maksymalnie: 100) |
| sort | string | Pole, według którego sortować (np. “name”, “created\_at”) |

**Odpowiedź:**

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

### Pobierz użytkownika po identyfikatorze

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

Zwraca pojedynczego użytkownika na podstawie identyfikatora.

**Odpowiedź:**

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

## Punkty końcowe produktów

### Pobierz wszystkie produkty

```http
GET /products
```

Zwraca listę wszystkich produktów. Obsługuje filtrowanie i paginację.

**Parametry zapytania:**

| Parametr | Typ | Opis |
| --- | --- | --- |
| category | string | Filtruj według kategorii |
| min\_price | number | Filtruj według ceny minimalnej |
| max\_price | number | Filtruj według ceny maksymalnej |
| page | integer | Numer strony (domyślnie: 1) |
| limit | integer | Liczba rekordów na stronę (domyślnie: 50, maksymalnie: 100) |

**Odpowiedź:**

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

## Obsługa błędów

Wszystkie punkty końcowe stosują standardowe kody statusu HTTP i tam, gdzie to zasadne, zawierają szczegółowe komunikaty o błędach:

| Kod statusu | Opis |
| --- | --- |
| 200 | OK, żądanie zakończone powodzeniem |
| 400 | Bad Request, nieprawidłowe parametry |
| 401 | Unauthorized, wymagane uwierzytelnienie |
| 403 | Forbidden, niewystarczające uprawnienia |
| 404 | Not Found, zasób nie istnieje |
| 429 | Too Many Requests, przekroczony limit zapytań |
| 500 | Internal Server Error, błąd po stronie serwera |

Odpowiedzi z błędem zawierają komunikat wyjaśniający, co poszło nie tak:

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