API-nøkler, tilganger og testmodus
Kort svar
Med Pro og Team oppretter du API-nøkler under Kontrollpanel > Domene og API. Hver nøkkel har en tilgang (Bare lese, Lese og skrive eller Full tilgang) og en modus: live-nøkler (pf_live_) virker på ordentlig, testnøkler (pf_test_) sender aldri e-post til noen, og overføringene deres utløper etter 24 timer.
Med Pandafile-API-et kan dine egne apper, skript og servere sende filer, samle inn opplastinger og be om signaturer. Det er inkludert i Pro og Team og følger de samme grensene som nettsiden. Alt begynner med en API-nøkkel.
Opprett en nøkkel
- Logg inn og åpne Kontrollpanel > Domene og API.
- Under API-nøkler gir du nøkkelen et navn, for eksempel Opplastinger fra nettsiden.
- Velg nøkkelmodus, Live eller Test, og nøkkeltilgang: Full tilgang, Lese og skrive eller Bare lese.
- Trykk Opprett nøkkel og kopier nøkkelen med en gang. Av sikkerhetshensyn viser vi den bare én gang.
- Send den med hver forespørsel i headeren Authorization: Bearer etterfulgt av nøkkelen.
Du kan ha opptil 10 aktive nøkler. Live-nøkler begynner med pf_live_ og testnøkler med pf_test_. Utviklerguiden finner du på pandafile.co/developers og API-referansen på pandafile.co/developers/api.
Tilganger: hva en nøkkel kan gjøre
- Bare lese: bare GET-forespørsler. Nøkkelen kan slå opp ting, men ikke endre noe.
- Lese og skrive: alt i Bare lese, og i tillegg opprette, endre og slette overføringer, filforespørsler, signaturforespørsler og webhook-abonnementer.
- Full tilgang: alt, også kontoinnstillinger som merkevare og teaminvitasjoner.
Testmodus
- Overføringer laget med en pf_test_-nøkkel er testdata. Ingen får noen gang e-post, heller ikke mottakere du legger til.
- Testoverføringer utløper alltid 24 timer etter at de ble opprettet, og kan ikke forlenges.
- De teller ikke mot noen grense, lagring eller bruk, og de vises ikke i de vanlige overføringslistene dine.
- Webhook-hendelser om dem har livemode satt til false, og de går aldri til Slack, Microsoft Teams eller Discord.
- Noen få handlinger virker bare med en live-nøkkel. Med en testnøkkel svarer API-et da med feilen test_mode_unsupported.
Hold nøklene trygge
- Alle som har en nøkkel, kan sende filer fra kontoen din. Oppbevar nøklene på serveren din, aldri i den offentlige koden til en nettside eller app.
- Tilbakekall en nøkkel under Kontrollpanel > Domene og API hvis den kan ha lekket. Apper som bruker den, slutter å virke med en gang, og webhook-abonnementer laget med den, for eksempel av Zapier eller Make, stopper også.
- Hver nøkkel har sin egen grense for antall forespørsler. Hvert svar viser hvor du står, i RateLimit-headerne.
- I et team er API-nøkler personlige: Hvert medlem oppretter sine egne.