Přejít na hlavní obsah
Lasso API je postaveno na principech REST. Všechny požadavky používají HTTPS a vrací odpovědi ve formátu JSON.

​
Základní URL

Všechny požadavky obsahují následující základní URL: 
https://hub.banditshq.com/api/v1

​
Autentizace

Pro autentizaci je potřeba přidat hlavičku Authorization s obsahem Bearer lasso_xxxxxxxxx, kde lasso_xxxxxxxxx je váš API klíč. 
Authorization: Bearer lasso_xxxxxxxxx
API klíče jsou vázané na jednu společnost. Všechny zdroje přístupné přes klíč patří dané společnosti. Více informací o správě klíčů a bezpečnostních doporučeních najdete na stránce Autentizace.

​
SDK

Oficiální SDK jsou k dispozici pro TypeScript a Python. 
npm install @lasso-ai/sdk

import LassoClient from "@lasso-ai/sdk";

const client = new LassoClient({ apiKey: "lasso_..." });

​
Stavové kódy

Lasso používá standardní HTTP kódy k indikaci úspěchu nebo selhání vašich požadavků.
StavTypPopis
200SuccessÚspěšný požadavek.
201CreatedZdroj byl úspěšně vytvořen.
204No ContentÚspěšné smazání.
400invalid_requestPožadavek je chybně formulovaný nebo používá nepodporovanou HTTP metodu.
401unauthenticatedChybějící, neplatný nebo deaktivovaný API klíč.
402insufficient_creditsVáš účet nemá dostatek kreditů.
403forbiddenAPI klíč nemá oprávnění k této akci.
404not_foundZdroj neexistuje nebo nepatří vaší společnosti.
409conflictPožadavek je v konfliktu s aktuálním stavem zdroje.
422validation_errorChybějící povinná pole nebo neplatné hodnoty.
429rate_limitedPříliš mnoho požadavků. Snižte frekvenci a zkuste to znovu.
500internal_errorNa serveru došlo k neočekávané chybě.
Úplný formát chybových odpovědí najdete v sekci Chyby.

​
Stránkování

Endpointy pro výpis seznamů podporují stránkování pomocí query parametrů page a limit. Výchozí velikost stránky je 25, maximum je 100. 
{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 143
  }
}
Podrobnosti a příklady iterace najdete v sekci Stránkování.

​
Webhooky

Při vytváření tabulky můžete nastavit webhook_url pro příjem HTTP POST notifikací po dokončení zpracování. Payloady webhooků jsou podepsány pomocí HMAC-SHA256 a v případě selhání se opakují až 3krát s exponenciálním prodlužováním intervalů. Formát doručení, ověření podpisu a pravidla opakování najdete v sekci Webhooky.