Opret og administrer API-nøgler
Opret en nøgle til den offentlige API, vælg dens scopes og udløb, begræns den efter IP-adresse, og tilbagekald den.
En API-nøgle lader dine værktøjer kalde Upsellrs offentlige API på vegne af din organisation. Adgang til API’en er forbeholdt abonnementet Enterprise.
Hvor du finder nøglerne
Åbn kontomenuen og derefter Manage og API & webhooks. På et andet abonnement end Enterprise viser sektionen »Included in the Enterprise plan« og en knap til at skifte abonnement.
Opret en nøgle
- Klik på Create API Key.
- Giv den et Name, der siger, hvad den bruges til, for eksempel navnet på det værktøj, der bruger den.
- Vælg et Scope preset:
- Read only: læse kanaler, produkter, kilder, workflows, medlemmer og organisationen.
- Read & Write: alt undtagen at starte workflows.
- Full access: alle scopes, inklusive at starte workflows.
- Custom: sæt flueben ved de ønskede scopes ét ad gangen.
- Vælg Expiration: 7 dage, 30 dage, 90 dage, 1 år, 3 år, No expiration eller en brugerdefineret varighed på 1 til 1.095 dage.
- Udfyld om nødvendigt Allowed IPs og Allowed User-Agents, adskilt af kommaer.
- Klik på Create Key.
Nøglen vises kun én gang. Kopiér den, og opbevar den et sikkert sted, før du lukker vinduet.
De tilgængelige scopes
| Ressource | Scopes |
|---|---|
| Kanaler | Oprette, læse, ændre, slette |
| Produkter | Oprette, læse, ændre, slette |
| Kilder | Læse, uploade kildefiler |
| Workflows | Læse, starte |
| Organisation | Læse organisationen, læse medlemmerne |
Tilbagekald en nøgle
Klik på Revoke ved siden af nøglen i listen. Enhver integration, der bruger den, holder straks op med at virke. Denne handling kan ikke fortrydes.
Godt at vide
- Kun ejere og administratorer opretter og tilbagekalder nøgler. Medlemmer kan kun se dem.
- Listen viser for hver nøgle dens scopes, dens udløbsdato og Last used: en nøgle, der aldrig er brugt, er ofte en nøgle, der bør tilbagekaldes.
- At starte et workflow kan involvere mange produkter og kreditter. Giv kun scopet til at starte workflows til de integrationer, der har brug for det.
- Opret én nøgle pr. integration med kun de nødvendige scopes.
- En mistet nøgle kan ikke vises igen: tilbagekald den, og opret en ny.