Pandafile · 50 GB gratis hver uke

API for filoverføring i appene og arbeidsflytene dine

Pandafile har et REST-API for å sende store filer fra din egen kode, dine servere og no-code-verktøy. Opprett en overføring, last opp filer med gjenopptakbar opplasting, send personlige lenker til mottakerne på e-post og få en webhook når noen laster ned. API-et er inkludert i Pro og Team, følger de samme grensene som nettappen og er beskrevet i et offentlig OpenAPI 3.1-dokument. Med testnøkler kan du bygge og kjøre tester uten å sende ekte e-poster eller bruke lagringsplassen din.

Les utviklerguiden

Et REST-API med en OpenAPI 3.1-beskrivelse

Alle endepunkter ligger under /api/v1 og bruker JSON. Du autentiserer deg med en API-nøkkel i Authorization-headeren som et Bearer-token. Nøklene opprettes i dashbordet ditt, vises bare én gang og kan begrenses til kun lesing, lesing og skriving eller full tilgang, slik at et rapportskript aldri får lov til å slette overføringer. Hele API-et er beskrevet i et maskinlesbart OpenAPI 3.1-dokument på /api/v1/openapi.json, som du kan laste inn i Postman, generere en klient fra eller gi til en AI-kodeassistent. Utviklerguiden på /developers forklarer konseptene, og API-referansen på /developers/api viser alle endepunkter med eksempler. Hvert svar har en forespørsels-ID, grenser for antall forespørsler oppgis i RateLimit-headere, lister bruker markørbasert paginering, og alle feil har samme JSON-format.

Gjenopptakbar opplasting med tus

Store filer og ustabile nettverk passer dårlig sammen med én lang HTTP-forespørsel. For å sende filer oppretter du først en overføring med POST /api/v1/transfers, der du oppgir filene, tittelen, meldingen og eventuelt mottakernes e-postadresser. Hver fil lastes deretter opp med tus, den åpne protokollen for gjenopptakbar opplasting, slik at en brutt forbindelse eller en omstartet server kan fortsette fra siste byte i stedet for å begynne på nytt. Det finnes ferdige tus-klienter for JavaScript, Python, Go, Java, .NET, Swift og flere. Når alle filene er oppe, kaller du complete, og overføringen blir en vanlig Pandafile-lenke med nedlastingsside, personlige lenker til mottakerne, påminnelser og utløpsdato. De samme plangrensene gjelder som i nettleseren: opptil 1000 GB per overføring og 1500 GB lagring med Pro.

Send filer rett fra en URL

Noen ganger ligger filen allerede et annet sted: et vedlegg i et CRM, resultatet fra en renderfarm eller en eksport på en annen server. POST /api/v1/transfers/from-url tar imot HTTPS-adresser og lar Pandafile hente filene for deg, og oppretter og fullfører deretter overføringen. Forespørselen venter i opptil 20 sekunder. Små importer kommer tilbake ferdige, mens større svarer med en gang med statusen uploading og fortsetter importen i bakgrunnen. Du kan følge fremdriften med GET /api/v1/transfers/{id}/import eller ganske enkelt vente på webhooken transfer.ready. Det er også slik integrasjonene med Zapier og Make sender filer uten at arbeidsflyten din først må laste dem ned.

Webhooks og varsler

I stedet for å spørre igjen og igjen kan du abonnere på hendelser. Pandafile kan kalle URL-en din når en overføring er klar, lastet ned eller utløpt, når en mottaker godkjenner filer eller ber om endringer, når noen laster opp til en av filforespørslene dine og når en signaturforespørsel er fullført. Hver levering signeres med HMAC-SHA256 i headeren Pandafile-Signature, slik at du kan sjekke at den virkelig kommer fra oss, og mislykkede leveringer prøves på nytt etter 1 minutt, 5 minutter, 30 minutter, 2 timer og 12 timer. Hendelsene lagres også i 30 dager og kan leses med GET /api/v1/events. Trenger du ikke kode i det hele tatt, kan de samme hendelsene sende meldinger til Slack, Microsoft Teams eller Discord.

Testnøkler, trygge nye forsøk og hva mer du kan automatisere

API-nøkler finnes i to moduser. Live-nøkler starter med pf_live_ og testnøkler med pf_test_. Overføringer som opprettes med en testnøkkel, sender aldri e-post, teller aldri mot lagringsplassen eller forbruket ditt, lagres bare i 24 timer og vises ikke i den vanlige listen over overføringer, så du kan kjøre integrasjonstester mot det ekte API-et uten bivirkninger. POST- og PATCH-forespørsler godtar headeren Idempotency-Key, så en forespørsel som sendes på nytt, oppretter aldri en ekstra overføring. I tillegg til overføringer dekker API-et mottakere og påminnelser, nedlastingshistorikk, lenkestatistikk og godkjenninger, filforespørsler, signaturforespørsler, merkevare og teaminvitasjoner. API-et er inkludert i Pro, fra $5.99 i måneden eller $49.99 i året, og i Team, fra $14.99 i måneden eller $129.99 i året. I et team har hvert medlem sine egne personlige nøkler.

Spørsmål

Har Pandafile et API?

Ja. Pandafile har et REST-API under /api/v1 for å opprette overføringer, laste opp filer, administrere mottakere, filforespørsler og signaturforespørsler og motta webhooks. Det er inkludert i planene Pro og Team.

Hvor finner jeg API-dokumentasjonen?

Utviklerguiden ligger på /developers, og den fullstendige API-referansen med eksempler ligger på /developers/api. Det maskinlesbare OpenAPI 3.1-dokumentet er offentlig på /api/v1/openapi.json.

Kan opplastinger gjenopptas hvis forbindelsen faller ut?

Ja. Filene lastes opp med tus-protokollen for gjenopptakbar opplasting, så en avbrutt opplasting fortsetter der den stoppet i stedet for å begynne på nytt.

Kan jeg teste uten å sende ekte e-poster?

Ja. Bruk en testnøkkel som starter med pf_test_. Testoverføringer sender aldri e-post, teller ikke mot lagringsplassen eller forbruket ditt og slettes etter 24 timer.

Kan jeg sende en fil som allerede ligger på nettet?

Ja. POST /api/v1/transfers/from-url henter filer fra HTTPS-adresser og gjør dem om til en overføring. Større importer fortsetter i bakgrunnen, og webhooken transfer.ready gir deg beskjed når lenken er klar.

Les utviklerguiden

Populært