Tokeny API a webhooky

Dostupnost

API a webhooky jsou součástí tarifů, které je obsahují (viz stránka s cenami). Pokud je váš tarif neobsahuje, stránka API a webhooky to řekne. Otevřít ji mohou jen vlastníci a správci.

Vytvořte token

1. Otevřete API a webhooky a najděte Tokeny.
2. Zadejte Název tokenu, například „naše CRM“. Ve výchozím stavu token jen čte. Zaškrtněte Může přidávat weby a spouštět kontroly, pokud má nástroj zapisovat.
3. Klikněte na Vytvořit token a hned ho zkopírujte: zobrazí se jen jednou. Pokud ho ztratíte, smažte token a vytvořte nový.

Tokeny, které už nepoužíváte, mažte; seznam ukazuje, kdy byl každý naposledy použit.

Volejte API

Základní adresu a odkaz na popis OpenAPI najdete v bloku Jak začít. Token posílejte v hlavičce:

curl -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" https://pandus.online/api/v1/sites

Přes API lze vypsat weby, přidat je a odebrat, spustit kontrolu a získat kontrolu, její zprávu a PDF. Token může posílat až 60 požadavků za minutu.

Webhooky

Webhook dá vašemu systému vědět, že se něco stalo, takže se nemusíte ptát. Klikněte na Přidat webhook, zadejte adresu https a zvolte události: dokončená kontrola (scan.completed) a nově nalezené problémy (issues.new). Tým může mít až pět adres.

Každá zpráva je podepsaná. V hlavičce Pandus-Signature je čas a podpis HMAC-SHA256 vytvořený vaším Podpisovým tajemstvím. Ověřte ho dřív, než zprávě uvěříte.

Odeslat test adresu vyzkouší. Protokol doručení uvádí každý pokus. Neúspěšná zpráva se opakuje až šestkrát během zhruba jednoho dne; můžete ji zopakovat i ručně. Adresa, která stále selhává, se po 20 neúspěších za sebou vypne. Adresy vedoucí do soukromé sítě se odmítají.