API-nycklar, åtkomstnivåer och testläge
Kort svar
Med Pro och Team skapar du API-nycklar under Dashboard > Domän & API. Varje nyckel har en åtkomst (Endast läsa, Läsa och skriva eller Full åtkomst) och ett läge: livenycklar (pf_live_) fungerar på riktigt, testnycklar (pf_test_) mejlar aldrig någon och deras överföringar går ut efter 24 timmar.
Med Pandafiles API kan dina egna appar, skript och servrar skicka filer, samla in uppladdningar och begära underskrifter. Det ingår i Pro och Team och följer samma gränser som webbplatsen. Allt börjar med en API-nyckel.
Skapa en nyckel
- Logga in och öppna Dashboard > Domän & API.
- Ge nyckeln ett namn under API-nycklar, till exempel Uppladdningar från webbplatsen.
- Välj nyckelläge, Live eller Test, och nyckelåtkomst: Full åtkomst, Läsa och skriva eller Endast läsa.
- Tryck på Skapa nyckel och kopiera nyckeln direkt. Av säkerhetsskäl visar vi den bara en gång.
- Skicka den med varje begäran i headern Authorization: Bearer följt av nyckeln.
Du kan ha upp till 10 aktiva nycklar. Livenycklar börjar med pf_live_ och testnycklar med pf_test_. Utvecklarguiden finns på pandafile.co/developers och API-referensen på pandafile.co/developers/api.
Åtkomstnivåer: vad en nyckel får göra
- Endast läsa: bara GET-begäranden. Nyckeln kan slå upp saker men inte ändra något.
- Läsa och skriva: allt i Endast läsa, plus att skapa, ändra och radera överföringar, filförfrågningar, signaturförfrågningar och webhook-prenumerationer.
- Full åtkomst: allt, även kontoinställningar som varumärke och teaminbjudningar.
Testläge
- Överföringar som skapas med en pf_test_-nyckel är testdata. Ingen mejlas någonsin, inte ens mottagare du lägger till.
- Testöverföringar går alltid ut 24 timmar efter att de skapades och kan inte förlängas.
- De räknas inte mot någon gräns, lagring eller användning, och de visas inte i dina vanliga listor över överföringar.
- Webhook-händelser om dem har livemode satt till false, och de skickas aldrig till Slack, Microsoft Teams eller Discord.
- Några få åtgärder fungerar bara med en livenyckel. Med en testnyckel svarar API:et då med felet test_mode_unsupported.
Håll nycklarna säkra
- Den som har en nyckel kan skicka filer från ditt konto. Förvara nycklar på din server, aldrig i den offentliga koden på en webbplats eller i en app.
- Återkalla en nyckel under Dashboard > Domän & API om den kan ha läckt. Appar som använder den slutar fungera direkt, och webhook-prenumerationer som skapats med den, till exempel av Zapier eller Make, upphör också.
- Varje nyckel har sin egen gräns för antal begäranden. Varje svar visar i RateLimit-headrarna var du ligger.
- I ett team är API-nycklar personliga: varje medlem skapar sina egna.