---
title: "Končne točke REST API | Tajo"
description: "Dokumentacija za končne točke REST API"
url: https://tajo.io/sl/docs/endpoints/rest-api/
markdown: https://tajo.io/sl/docs/endpoints/rest-api.md
lang: sl-SI
author: "Set Noa"
author_url: https://tajo.io/sl/set-noa/
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Končne točke REST API

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

Caution

**Predstavitvena stran**, to je predstavitvena stran, ki prikazuje funkcijo dokumentacije z več zavihki. Vsebina je zgolj ponazoritvena.

Naš REST API ponuja končne točke za dostop do podatkov in njihovo spreminjanje. Vse končne točke vračajo podatke v obliki JSON.

## Osnovni URL

Vse zahteve API pošljite na naslednji osnovni URL:

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

## Končne točke za uporabnike

### Pridobitev vseh uporabnikov

```http
GET /users
```

Vrne seznam vseh uporabnikov. Podpira parametre za razdelitev na strani.

**Parametri poizvedbe:**

| Parameter | Tip | Opis |
| --- | --- | --- |
| page | integer | Številka strani (privzeto: 1) |
| limit | integer | Število zapisov na stran (privzeto: 50, največ: 100) |
| sort | string | Polje za razvrščanje (na primer “name”, “created\_at”) |

**Odgovor:**

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

### Pridobitev uporabnika po ID-ju

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

Vrne enega uporabnika glede na ID.

**Odgovor:**

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

## Končne točke za izdelke

### Pridobitev vseh izdelkov

```http
GET /products
```

Vrne seznam vseh izdelkov. Podpira filtriranje in razdelitev na strani.

**Parametri poizvedbe:**

| Parameter | Tip | Opis |
| --- | --- | --- |
| category | string | Filtriranje po kategoriji |
| min\_price | number | Filtriranje po najnižji ceni |
| max\_price | number | Filtriranje po najvišji ceni |
| page | integer | Številka strani (privzeto: 1) |
| limit | integer | Število zapisov na stran (privzeto: 50, največ: 100) |

**Odgovor:**

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

## Obravnava napak

Vse končne točke upoštevajo standardne statusne kode HTTP in po potrebi vključijo podrobno sporočilo o napaki:

| Statusna koda | Opis |
| --- | --- |
| 200 | OK, zahteva je uspela |
| 400 | Bad Request, neveljavni parametri |
| 401 | Unauthorized, potrebno je preverjanje pristnosti |
| 403 | Forbidden, nezadostna dovoljenja |
| 404 | Not Found, vir ne obstaja |
| 429 | Too Many Requests, presežena je omejitev števila zahtev |
| 500 | Internal Server Error, prišlo je do napake na strežniku |

Odgovori z napako vsebujejo sporočilo, ki pojasni, kaj je šlo narobe:

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