Skapa och hantera API-nycklar
Skapa en nyckel för det publika API:et, välja dess behörigheter och giltighetstid, begränsa den per IP-adress och sedan återkalla den.
En API-nyckel låter dina verktyg anropa Upsellrs publika API för din organisations räkning. Åtkomst till API:et är förbehållen planen Enterprise.
Var du hittar nycklarna
Öppna kontomenyn och sedan Manage och API & webhooks. På en annan plan än Enterprise visar avsnittet Included in the Enterprise plan och en knapp för att byta plan.
Skapa en nyckel
- Klicka på Create API Key.
- Ge den ett Name som säger vad den används till, till exempel namnet på verktyget som använder den.
- Välj en Scope preset:
- Read only: läsa kanaler, produkter, källor, workflows, medlemmar och organisationen.
- Read & Write: allt, utom att starta workflows.
- Full access: alla behörigheter, inklusive att starta workflows.
- Custom: kryssa i de behörigheter du vill ha en i taget.
- Välj Expiration: 7 dagar, 30 dagar, 90 dagar, 1 år, 3 år, No expiration, eller en anpassad tid från 1 till 1 095 dagar.
- Fyll vid behov i Allowed IPs och Allowed User-Agents, åtskilda med kommatecken.
- Klicka på Create Key.
Nyckeln visas bara en gång. Kopiera den och förvara den på ett säkert ställe innan du stänger fönstret.
Tillgängliga behörigheter
| Resurs | Behörigheter |
|---|---|
| Kanaler | Skapa, läsa, ändra, ta bort |
| Produkter | Skapa, läsa, ändra, ta bort |
| Källor | Läsa, ladda upp källfiler |
| Workflows | Läsa, starta |
| Organisation | Läsa organisationen, läsa medlemmarna |
Återkalla en nyckel
Klicka på Revoke bredvid nyckeln i listan. Alla integrationer som använder den slutar fungera omedelbart. Åtgärden går inte att ångra.
Bra att veta
- Bara ägare och administratörer skapar och återkallar nycklar. Medlemmar ser dem skrivskyddade.
- Listan visar för varje nyckel dess behörigheter, dess utgångsdatum och Last used: en nyckel som aldrig har använts är ofta en nyckel som bör återkallas.
- Att starta ett workflow kan omfatta många produkter och krediter. Ge bara behörigheten att starta till de integrationer som behöver den.
- Skapa en nyckel per integration, med enbart de behörigheter som behövs.
- En nyckel som har gått förlorad kan inte visas igen: återkalla den och skapa en ny.