Přejít na hlavní obsah
Místo opakovaného dotazování na změny stavu můžete při vytváření tabulky nastavit webhook URL. API odešle HTTP POST požadavky na váš endpoint, když dojde k událostem.

​
Konfigurace webhooku

Při vytváření tabulky předejte webhook_url. 
curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Product catalog",
    "file_ids": ["file_xyz"],
    "webhook_url": "https://your-server.com/webhooks/lasso"
  }'

​
Payload webhooku

Každé doručení je JSON POST požadavek s následující strukturou. 
{
  "event": "table.completed",
  "timestamp": "2025-03-12T14:30:00.000Z",
  "data": {
    "table_id": "tbl_abc123",
    "status": "completed",
    "total_rows": 42
  }
}

​
Hlavičky

Každý webhook požadavek obsahuje tyto hlavičky:
HlavičkaPopis
Content-TypeVždy application/json.
X-Lasso-EventTyp události (např. table.completed).
X-Lasso-Delivery-IdUnikátní identifikátor tohoto pokusu o doručení.
X-Lasso-SignatureHMAC-SHA256 podpis těla požadavku (pokud je nakonfigurován secret).

​
Ověření podpisu

Pokud zadáte webhook secret, API podepíše každý payload pomocí HMAC-SHA256. Podpis je odeslán v hlavičce X-Lasso-Signature s prefixem sha256=. 
import hmac
import hashlib

def verify_signature(payload: bytes, signature: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(
        secret.encode(), payload, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

​
Pravidla opakování

Pokud váš endpoint neodpoví stavovým kódem 2xx do 10 sekund, API zopakuje požadavek s exponenciálním prodlužováním intervalů:
PokusProdleva
1. opakování30 sekund
2. opakování5 minut
3. opakování30 minut
Po 3 neúspěšných pokusech je doručení ukončeno. Stav tabulky můžete kdykoli zkontrolovat přes API.

​
Vlastní autentizační hlavičky

Při vytváření tabulky můžete nastavit vlastní autentizační hlavičku pro doručování webhooků pomocí parametrů webhook_auth_header_name a webhook_auth_header_value ve vstupních datech.