Přejít na obsah

Veřejné API

Vytvořte API klíč a zvolte jeho scopes

Vytvořte klíč ve workspace, ve kterém bude působit, udělte jen ty scopes, které integrace potřebuje, a uložte ho jako tajemství. Klíč se zobrazí jednou — pokud se ztratí, zneplatněte ho a vydejte nový.

Kroky

  1. Vytvořte klíč uvnitř workspace, jehož kódů se dotkne. Klíče mezi workspace nepřecházejí.
  2. Udělte nejužší scopes, se kterými integrace funguje — jen čtení, pokud jen čte.
  3. Zkopírujte klíč hned do svého úložiště tajemství.
  4. Autentizujte se tokenem Bearer nebo hlavičkou X-Mosaqo-API-Key, podle vašeho klienta.
  5. Omezte podle adresy, kde to jde, a rotujte podle plánu.

Jak ověřit výsledek

Zavolejte identitní endpoint, například /me. Měl by odpovědět očekávaným workspace, což zároveň potvrdí, kde klíč platí.

Co se obvykle pokazí

  • Klíč zacommitovaný do repozitáře nebo vložený do chatu.
  • Jeden všemocný klíč sdílený všemi integracemi.
  • Klíč vytvořený ve špatném workspace, který pak na vše vrací 403.
Vyřešilo to váš problém?

Tohle nepomohlo

Napište nám s platformou a verzí, kroky, které jste udělali, očekávaným výsledkem a workspace nebo QR kódem, kterého se to týká. Než cokoli přiložíte, zamaskujte každé tajemství.

Napsat podpoře