Přejít na hlavní obsah

Documentation Index

Fetch the complete documentation index at: https://productlasso.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.