Detail API přístupu

GET

/api/v2/admin/machine-tokens/{id}

Vrátí API přístup podle číselného ID. Zobrazit můžete všechny přístupy své firmy, i ty, které vlastní jiný uživatel. Pole viewerIsOwner říká, zda přístup patří vám. Zobrazit lze i odvolaný nebo expirovaný přístup. Přístup jiné firmy vrací stejnou chybu 404 jako neexistující ID.

Hodnota tokenu se v detailu nevrací. Novou hodnotu aktivního přístupu získáte rotací.

Pole odpovědi

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.

Dále obsahuje noExpiration, adresu API apiOrigin, ukázky volání samples a viewerIsOwner. samples jsou šablony volání, ne skutečná hodnota tokenu.

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.

Operace vyžaduje modul 10223 API přístupy. 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

Parametry cesty

Název	Typ	Povinný	Popis	Příklad
`id`	integer	ano	Číselné ID API přístupu vaší firmy (pole id), ne předpona ani hodnota tokenu.	`1`

Příklad požadavku

curl

curl -X GET 'https://www.elpokladny.cz/api/v2/admin/machine-tokens/1' \
  -H 'Authorization: Bearer elp_live_example.example_secret'

PHP

<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/admin/machine-tokens/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/1", {
    "method": "GET",
    "headers": {
        "Authorization": "Bearer elp_live_example.example_secret"
    }
});
const data = await response.json();

Ukázkové odpovědi

Metadata přístupu (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",
    "noExpiration": false,
    "apiOrigin": "https://www.elpokladny.cz",
    "samples": {
      "bearerHeader": "Authorization: Bearer elp_live_example.example_secret",
      "urlQuery": "https://www.elpokladny.cz/api/v2/docs?api_token=example.example_secret",
      "curlBearer": "curl -H \"Authorization: Bearer elp_live_example.example_secret\" https://www.elpokladny.cz/api/v2/docs",
      "curlPdf": "curl -H \"Authorization: Bearer elp_live_example.example_secret\" https://www.elpokladny.cz/api/v2/docs/1/pdf -o doklad.pdf"
    },
    "viewerIsOwner": true
  }
}

Chybí modul API přístupy (HTTP 403)

application/json

{
  "status": "error",
  "message": "Chybí modul API přístupy (#10223)."
}

API přístup neexistuje v této firmě (HTTP 404)

application/json

{
  "status": "error",
  "message": "Token nebyl nalezen."
}

Možné chyby

Chybové stavy

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
404	ID neexistuje nebo přístup patří jiné firmě.	status-message

Související návody

API přístupy