Seznam API přístupů
/api/v2/admin/machine-tokensVypíše API přístupy vaší firmy, včetně odvolaných a expirovaných. Záznamy jsou seřazené podle ID sestupně, stránka obsahuje nejvýše 20 záznamů. Pole pages je vždy alespoň 1, i když je seznam prázdný. Stránka za koncem seznamu vrátí prázdné data.
defaults.expiresAt je výchozí datum expirace pro nový přístup: dnešní datum + 12 měsíců ve formátu YYYY-MM-DD. Nejde o expiraci vrácených záznamů. Seznam nikdy nevrací hodnotu tokenu.
Pole odpovědi
Každý přístup obsahuje id, type (BEARER nebo URL), name, zkrácenou předponu tokenu tokenPrefix, IP pravidla (allowAllIps, allowedIps), expiresAt, status (ACTIVE, EXPIRED, REVOKED), vlastníka user (id, name, username), revokedAt, revokedBy, lastUsedAt, lastUsedIp a createdAt. Pole legacy a legacyUid jsou příznakem starého typu přístupu.
Nevyplněné časové údaje jsou null. Časy mají formát YYYY-MM-DD HH:MM:SS bez časové zóny. Údaj o posledním použití se neaktualizuje při každém volání, nejde o úplný záznam provozu. Text <zkrácená předpona> v ukázce je zástupná hodnota.
Další pole (noExpiration, apiOrigin, ukázky volání samples a viewerIsOwner) vrací detail API přístupu.
Operace vyžaduje modul 10223 API přístupy a pracuje jen s přístupy vaší firmy. Odpověď se neukládá do cache (Cache-Control: no-store). Více v sekcích Autentizace, Oprávnění a moduly a Chybové stavy.
Autentizace a oprávnění
Vyžaduje API token: Bearer v hlavičce nebo URL token.
10223 - API přístupy Bez modulu API přístupy vrací operace HTTP 403. Modul musí mít uživatel, kterému patří použitý API token.API přístupy
Parametry
Query parametry
| Název | Typ | Povinný | Popis | Příklad |
|---|---|---|---|---|
page | integer | ne | Číslo stránky, výchozí 1. Hodnota menší než 1 se bere jako 1. | 1 |
Příklad požadavku
curl
curl -X GET 'https://www.elpokladny.cz/api/v2/admin/machine-tokens?page=1' \
-H 'Authorization: Bearer elp_live_example.example_secret'PHP
<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/admin/machine-tokens?page=1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array (
0 => 'Authorization: Bearer elp_live_example.example_secret',
),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;javascript
const response = await fetch("https://www.elpokladny.cz/api/v2/admin/machine-tokens?page=1", {
"method": "GET",
"headers": {
"Authorization": "Bearer elp_live_example.example_secret"
}
});
const data = await response.json();Ukázkové odpovědi
Stránka přístupů (HTTP 200)
application/json
{
"status": "success",
"data": [
{
"id": 1,
"type": "BEARER",
"name": "Ukázkový e-shop",
"tokenPrefix": "<zkrácená předpona>",
"legacy": false,
"legacyUid": null,
"allowAllIps": false,
"allowedIps": "192.0.2.10",
"expiresAt": "2027-10-30 23:59:59",
"status": "ACTIVE",
"user": {
"id": 101,
"name": "Ukázkový uživatel",
"username": "integrator.ukazka"
},
"revokedAt": null,
"revokedBy": null,
"lastUsedAt": null,
"lastUsedIp": null,
"createdAt": "2026-10-30 12:00:00"
}
],
"page": 1,
"pages": 1,
"defaults": {
"expiresAt": "2027-10-30"
}
}
Chybí modul API přístupy (HTTP 403)
application/json
{
"status": "error",
"message": "Chybí modul API přístupy (#10223)."
}
Možné chyby
| HTTP | Kdy | Podoba |
|---|---|---|
| 401 | Chybí nebo je neplatný API token. | status-message |
| 403 | Chybí modul 10223 nebo požadavek nepřichází z IP adresy povolené pro API token. | status-message |