API-nøgler, adgangsniveauer og testtilstand
Kort svar
Med Pro og Team opretter du API-nøgler under Dashboard > Domæne og API. Hver nøgle har en adgang (Kun læse, Læse og skrive eller Fuld adgang) og en tilstand: livenøgler (pf_live_) virker for alvor, testnøgler (pf_test_) sender aldrig e-mails til nogen, og deres overførsler udløber efter 24 timer.
Med Pandafile-API'et kan dine egne apps, scripts og servere sende filer, indsamle uploads og bede om underskrifter. Det er inkluderet i Pro og Team og følger de samme grænser som hjemmesiden. Alt starter med en API-nøgle.
Opret en nøgle
- Log ind, og åbn Dashboard > Domæne og API.
- Giv nøglen et navn under API-nøgler, fx Uploads fra hjemmesiden.
- Vælg nøgletilstanden, Live eller Test, og nøgleadgangen: Fuld adgang, Læse og skrive eller Kun læse.
- Tryk på Opret nøgle, og kopiér nøglen med det samme. Af sikkerhedshensyn viser vi den kun én gang.
- Send den med hver forespørgsel i headeren Authorization: Bearer efterfulgt af nøglen.
Du kan have op til 10 aktive nøgler. Livenøgler starter med pf_live_ og testnøgler med pf_test_. Udviklervejledningen findes på pandafile.co/developers og API-referencen på pandafile.co/developers/api.
Adgangsniveauer: hvad en nøgle må
- Kun læse: kun GET-forespørgsler. Nøglen kan slå ting op, men ikke ændre noget.
- Læse og skrive: alt i Kun læse plus oprette, ændre og slette overførsler, filanmodninger, underskriftsanmodninger og webhook-abonnementer.
- Fuld adgang: alt, også kontoindstillinger som design og teaminvitationer.
Testtilstand
- Overførsler lavet med en pf_test_-nøgle er testdata. Der sendes aldrig e-mails til nogen, heller ikke til modtagere, du tilføjer.
- Testoverførsler udløber altid 24 timer efter, de blev oprettet, og kan ikke forlænges.
- De tæller ikke med i nogen grænse, lagerplads eller forbrug, og de vises ikke i dine almindelige lister over overførsler.
- Webhook-hændelser om dem har livemode sat til false, og de sendes aldrig til Slack, Microsoft Teams eller Discord.
- Nogle få handlinger virker kun med en livenøgle. Med en testnøgle svarer API'et så med fejlen test_mode_unsupported.
Pas godt på dine nøgler
- Alle med en nøgle kan sende filer fra din konto. Opbevar nøgler på din server, aldrig i den offentlige kode på en hjemmeside eller i en app.
- Tilbagekald en nøgle under Dashboard > Domæne og API, hvis den kan være lækket. Apps, der bruger den, holder op med at virke med det samme, og webhook-abonnementer oprettet med den, fx af Zapier eller Make, stopper også.
- Hver nøgle har sin egen grænse for antal forespørgsler. Hvert svar viser i RateLimit-headerne, hvor du står.
- I et team er API-nøgler personlige: Hvert medlem opretter sine egne.