Rýchly štart

Kľúč, prvé volanie, prvý webhook: viac na začiatok nepotrebujete.

1. Vytvorenie kľúča

V Apexe otvorte ponuku účtu a vyberte API a webhooky. Kľúč môže vytvoriť Superpoužívateľ účtu alebo Administrátor, a práve oni vidia aj protokol volaní a webhooky. Ak vývojár kľúč vytvára a protokol sleduje sám, potrebuje v účte spoločnosti rolu Administrátora.

Pre každú spoločnosť existuje jeden plný testovací a jeden plný ostrý kľúč a popri nich ľubovoľný počet pomenovaných kľúčov na reporty, ktoré čítajú iba účet a reporty kampaní a dajú sa zrušiť jednotlivo. Po vytvorení nového ostrého kľúča funguje starý ešte 7 dní, potom volania s ním dostanú odpoveď 401 api_key_expired: toľko času máte na výmenu. Kľúč patrí tvorcovi a funguje s jeho prístupom. Ak tvorca opustí tím alebo stratí rolu Administrátora, kľúč zostane, ale každé volanie dostane odpoveď 403 api_key_creator_inactive, kým ho Superpoužívateľ alebo Administrátor neprevezme v časti API a webhooky; hodnota kľúča zostane rovnaká.

2. Prvé volanie

Skontrolujte kľúč: GET /v1/account ukáže, ku ktorej spoločnosti patrí, kto ho vytvoril a či beží ostro alebo v testovacom režime (livemode). V ukážkach sa kľúč berie z premennej prostredia TRENDIZZ_KEY.

curl "https://api.trendizz.com/v1/account" \
  -H "Authorization: Bearer $TRENDIZZ_KEY"

3. Prvý webhook

Pridajte endpoint volaním POST /v1/webhook-endpoints: zadajte vlastnú adresu https a požadované typy udalostí. Podpisové tajomstvo (whsec_…) odpoveď obsahuje iba raz, preto si ho uložte. POST /v1/webhook-endpoints/{id}/test odošle testovaciu udalosť, takže overenie podpisu si môžete vyskúšať aj s testovacím kľúčom.

curl -X POST "https://api.trendizz.com/v1/webhook-endpoints" \
  -H "Authorization: Bearer $TRENDIZZ_KEY" \
  -H "Idempotency-Key: my-request-1" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://crm.acme.example/hooks/trendizz",
    "events": [
      "positive_response.created",
      "suppression.created"
    ],
    "description": "CRM sync"
  }'