Konfigurácia
Nakonfigurujte cieľovú adresu a odbery svojej organizácie cez Platform alebo API.
Každá organizácia má jednu cieľovú adresu webhookov a jeden aktívny signing secret (podpisový kľúč). Nakonfigurujte ich v Platform alebo zo svojho servera.
| Údaj | Hodnota |
|---|---|
| Základná URL | https://api.sandbox.tapaya.com pre sandbox, https://api.tapaya.com pre produkčné prostredie |
| Autentifikácia | Server Secret Token v hlavičke Authorization. Pozrite si Autentifikáciu. |
| Rozsah | Jedna cieľová adresa na organizáciu |
| Súvisiaci návod | Overenie a testovanie |
Nastavte webhooky v Platform
Otvorte API Keys pre svoju organizáciu a nájdite Webhooks.
- Zadajte svoju verejnú HTTPS URL.
- Vyberte udalosti, ktoré potrebujete, alebo zapnite Subscribe to all webhook types.
- Zapnite Enable a kliknite na Save.
- Skopírujte signing secret a uložte ho na svojom serveri.
- Odošlite testovací webhook.
Signing secret sa zobrazí iba raz
Skopírujte ho pri vytvorení alebo rotácii cieľovej adresy; neskôr ho už nemožno získať. Slúži iba na overenie prichádzajúcich webhookov. Konfiguračné požiadavky autorizuje váš Server Secret Token.
Všetky operácie
| Operácia | Slúži na |
|---|---|
| Uloženie cieľovej adresy | Vytvorenie alebo nahradenie aktuálneho odberu, prípadne rotácia jeho signing secret. |
| Načítanie cieľovej adresy | Získanie aktuálnej URL, režimu odberu a stavu zapnutia. |
| Odstránenie cieľovej adresy | Odstránenie odberu aj jeho frontu a histórie doručovania. |
Správa cieľovej adresy
Pravidlá cieľovej adresy
Zmena nastavení
| Keď | Čo sa stane |
|---|---|
| Zmeníte URL, udalosti alebo kľúč | Nové udalosti použijú nové nastavenia. Udalosti vo fronte si ponechajú pôvodnú URL a kľúč, preto nechajte oboje funkčné, kým sa front nevyprázdni. |
| Vypnete webhooky | Doručovanie z frontu sa pozastaví a nové udalosti sa nezachytávajú. Opätovné zapnutie obnoví spracovanie frontu, ale zmeškané zmeny sa spätne nedoplnia. Testy fungujú aj naďalej. |
| Odstránite cieľovú adresu | Udalosti vo fronte a história doručovania sa odstránia. Požiadavka, ktorá sa už odosiela, môže ešte prísť. Opätovné vytvorenie vygeneruje nový signing secret. |
Požiadavky na URL
- Verejné HTTPS na porte 443. Localhost a súkromné siete sú odmietnuté a DNS sa pri každom pripojení kontroluje znova.
- Žiadne vložené prihlasovacie údaje, žiadny fragment a žiadne presmerovania.
- Žiadne vlastné autorizačné hlavičky. Namiesto toho overujte podpis Tapaya alebo pred URL, ktorá vyžaduje vlastný kľúč, umiestnite serverový adaptér.
Chyby
Požiadavky na konfiguráciu zlyhávajú s týmito odpoveďami. Prijímač, ktorý doručenie odmietne alebo ho nezachytí, je iný problém; pozrite si časť Riešenie chýb.
| Odpoveď | Význam |
|---|---|
400 pri PUT | Neplatná URL, nepodporovaný typ udalosti, chýbajúce povinné pole alebo prázdny explicitný výber udalostí. |
401 | Server Secret Token chýba alebo je neplatný. |
404 pri GET | Pre autentifikovanú organizáciu neexistuje cieľová adresa. |
Pokračujte na overenie podpisu a testovacie doručenie.
Chýba vám niečo na tejto stránke?Navrhnite funkciu. Pripojíme túto stránku, aby tím videl súvislosti.