Naar de inhoud

Publieke API

Maak een API-sleutel en kies de scopes

Maak de sleutel in de workspace waarin hij zal werken, geef alleen de scopes die de integratie nodig heeft, en bewaar hem als een geheim. Een sleutel wordt één keer getoond — raakt hij kwijt, trek hem in en geef een nieuwe uit.

Stappen

  1. Maak de sleutel binnen de workspace waarvan hij de codes raakt. Sleutels gelden niet over workspaces heen.
  2. Geef de smalste scopes waarmee de integratie werkt — alleen lezen als hij alleen leest.
  3. Kopieer de sleutel meteen naar je secretenkluis.
  4. Authenticeer met een Bearer-token of de header X-Mosaqo-API-Key, wat je client uitkomt.
  5. Beperk op adres waar dat kan, en roteer volgens schema.

Hoe je het resultaat controleert

Roep een identiteitsendpoint aan zoals /me. Dat hoort te antwoorden met de verwachte workspace, wat meteen bevestigt waar de sleutel geldt.

Wat er meestal misgaat

  • Een sleutel in een repository gecommit of in een chat geplakt.
  • Eén almachtige sleutel gedeeld door alle integraties.
  • Een sleutel in de verkeerde workspace gemaakt, die daarna op alles 403 geeft.
Heeft dit je probleem opgelost?

Dit hielp niet

Schrijf ons met platform en versie, de stappen die je nam, het verwachte resultaat en de betrokken workspace of QR-code. Maskeer elk geheim voordat je iets bijvoegt.

Schrijf naar support