Odvolání API přístupu

POST

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

Odvolá API přístup a zaznamená čas odvolání (revokedAt) a uživatele, který ho provedl (revokedBy). Odvolat lze i expirovaný přístup. Opakované volání pro už odvolaný přístup nic nemění a vrátí úspěšný detail. Tělo požadavku není potřeba.

Pokud odvoláte token, kterým právě voláte, tato odpověď ještě může být úspěšná. Další požadavky s tímto tokenem už dostanou 401. Odvolaný přístup zůstává v seznamu i v detailu se stavem REVOKED. Odpověď neobsahuje hodnotu tokenu.

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 (zda přístup patří vám). 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. 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 POST 'https://www.elpokladny.cz/api/v2/admin/machine-tokens/1/revoke' \
  -H 'Authorization: Bearer elp_live_example.example_secret'

PHP

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

Ukázkové odpovědi

Odvolaný 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": "REVOKED",
    "user": {
      "id": 101,
      "name": "Ukázkový uživatel",
      "username": "integrator.ukazka"
    },
    "revokedAt": "2026-10-30 12:05:00",
    "revokedBy": "Ukázkový uživatel",
    "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	Přístup neexistuje nebo je z jiné firmy.	status-message

Související návody

API přístupy