Ein Lager, aus dem die Daten wieder herauskommen

curl -H "Authorization: Bearer cstrg_ab12cd34_…" \
  https://www.cloudstrg.sk/api/v1/info

Wer den Header Authorization nicht setzen kann (manche Low-Code-Werkzeuge), schickt den Schlüssel in X-Api-Key.

Die Antwort hat immer dieselbe Form

{ "ok": true,  "data": … }
{ "ok": false, "chyba": { "kod": "nenajdene", "sprava": "…" } }

So muss eine Integration nicht auf den HTTP-Status schauen, um zu wissen, ob sie erfolgreich war — ok genügt. Listen tragen zusätzlich strankovanie mit limit, offset und celkom.

Die Status, die kommen können

• 200 / 201 — in Ordnung
• 401 — fehlender oder ungültiger Schlüssel
• 402 — das Paket ist voll, eine neue Position passt nicht mehr hinein
• 404 — die Sache existiert nicht oder gehört nicht Ihrer Firma
• 422 — fehlender oder unsinniger Parameter
• 429 — Aufrufgrenze überschritten; versuchen Sie es in einer Minute

Was ist dieser Code vom Etikett

curl -H "Authorization: Bearer $KLUC" \
  https://www.cloudstrg.sk/api/v1/kod/K-9WZ2QK

{
  "ok": true,
  "data": {
    "typ": "kontajner",
    "kod": "K-9WZ2QK",
    "id": 412,
    "nazov": "Účtovníctvo 2023",
    "popis": "Košice · R1 · R1-2"
  }
}

Einen Karton über eine Sache darin finden

curl -H "Authorization: Bearer $KLUC" \
  "https://www.cloudstrg.sk/api/v1/hladat?q=vŕtačka"

Einen Karton anlegen und gleich einordnen

curl -X POST -H "Authorization: Bearer $KLUC" \
  -H "Content-Type: application/json" \
  -d '{"nazov":"Faktúry 2026","typ":"sanon","polica_id":12}' \
  https://www.cloudstrg.sk/api/v1/kontajnery

Der Code wird automatisch vergeben und kommt in der Antwort zurück — das Etikett dazu drucken Sie dann in der App. Über Codes entscheidet die App bewusst, damit nicht zwei gleiche entstehen können.