Pandafile · Elke week 50 GB gratis
Een API om bestanden te versturen vanuit je apps en workflows
Pandafile heeft een REST API om grote bestanden te versturen vanuit je eigen code, servers en no-codetools. Maak een transfer, upload bestanden met hervatbare uploads, stuur ontvangers persoonlijke links per e-mail en krijg een webhook zodra iemand downloadt. De API zit in Pro en Team, volgt dezelfde limieten als de webapp en is beschreven in een openbaar OpenAPI 3.1-document. Met testsleutels bouw en test je zonder echte e-mails te versturen of je opslag te gebruiken.
Een REST API met een OpenAPI 3.1-beschrijving
Alle endpoints staan onder /api/v1 en werken met JSON. Je authenticeert met een API-sleutel als Bearer-token in de Authorization-header. Sleutels maak je aan in je dashboard, ze worden maar één keer getoond en je kunt ze beperken tot alleen lezen, lezen en schrijven of volledige toegang. Zo krijgt een rapportagescript nooit de macht om transfers te verwijderen. De hele API is beschreven in een machineleesbaar OpenAPI 3.1-document op /api/v1/openapi.json, dat je in Postman kunt laden, kunt gebruiken om een client te genereren of aan een AI-codeerassistent kunt geven. De ontwikkelaarsgids op /developers legt de concepten uit, en de API-referentie op /developers/api toont elk endpoint met voorbeelden. Elk antwoord bevat een request-ID, rate limits staan in RateLimit-headers, lijsten gebruiken cursorpaginering en fouten hebben één vast JSON-formaat.
Hervatbare uploads met tus
Grote bestanden en wankele netwerken gaan slecht samen met één lang HTTP-verzoek. Om bestanden te versturen maak je eerst een transfer met POST /api/v1/transfers, met de bestanden, de titel, het bericht en eventueel de e-mailadressen van ontvangers. Elk bestand wordt daarna geüpload met tus, het open protocol voor hervatbare uploads, zodat een weggevallen verbinding of een herstarte server verdergaat vanaf de laatste byte in plaats van opnieuw te beginnen. Er zijn kant-en-klare tus-clients voor onder meer JavaScript, Python, Go, Java, .NET en Swift. Staan alle bestanden erop, dan roep je complete aan en wordt de transfer een gewone Pandafile-link met downloadpagina, persoonlijke links voor ontvangers, herinneringen en een vervaldatum. Dezelfde abonnementslimieten gelden als in de browser: tot 1000 GB per transfer en 1500 GB opslag met Pro.
Bestanden direct vanaf een URL versturen
Soms staat het bestand al ergens anders: een bijlage in je CRM, de output van een renderfarm of een export op een andere server. POST /api/v1/transfers/from-url accepteert HTTPS-URL's en laat Pandafile de bestanden voor je ophalen, waarna de transfer wordt aangemaakt en afgerond. Het verzoek wacht maximaal 20 seconden. Kleine imports komen klaar terug, grotere geven meteen de status uploading terug terwijl de import op de achtergrond doorloopt. Je volgt de voortgang met GET /api/v1/transfers/{id}/import, of je wacht gewoon op de webhook transfer.ready. Zo versturen ook de integraties met Zapier en Make bestanden, zonder dat je workflow ze eerst hoeft te downloaden.
Webhooks en meldingen
In plaats van steeds te pollen abonneer je je op gebeurtenissen. Pandafile kan je URL aanroepen wanneer een transfer klaar is, gedownload of verlopen, wanneer een ontvanger bestanden goedkeurt of wijzigingen vraagt, wanneer iemand iets uploadt naar een van je bestandsverzoeken en wanneer een ondertekeningsverzoek is afgerond. Elke levering is ondertekend met HMAC-SHA256 in een Pandafile-Signature-header, zodat je kunt controleren dat hij echt van ons komt. Mislukte leveringen worden opnieuw geprobeerd na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur. Gebeurtenissen worden ook 30 dagen bewaard en zijn op te vragen met GET /api/v1/events. Wil je helemaal geen code schrijven, dan kunnen dezelfde gebeurtenissen berichten plaatsen in Slack, Microsoft Teams of Discord.
Testsleutels, veilig opnieuw proberen en wat je nog meer kunt automatiseren
API-sleutels zijn er in twee modi: livesleutels beginnen met pf_live_ en testsleutels met pf_test_. Transfers die je met een testsleutel maakt, versturen nooit e-mails, tellen nooit mee voor je opslag of gebruik, worden maar 24 uur bewaard en verschijnen niet in je gewone lijst met transfers. Zo draai je integratietests tegen de echte API zonder bijwerkingen. POST- en PATCH-verzoeken accepteren een Idempotency-Key-header, zodat een herhaald verzoek nooit een tweede transfer aanmaakt. Naast transfers dekt de API ontvangers en herinneringen, downloadgeschiedenis, linkstatistieken en goedkeuringen, bestandsverzoeken, ondertekeningsverzoeken, huisstijl en teamuitnodigingen. De API zit in Pro, vanaf $5,99 per maand of $49,99 per jaar, en in Team, vanaf $14,99 per maand of $129,99 per jaar. In een team heeft elk lid zijn eigen persoonlijke sleutels.
Ontwikkelaarsgids · API-referentie · OpenAPI 3.1-document
Vragen
Heeft Pandafile een API?
Ja. Pandafile heeft een REST API onder /api/v1 om transfers te maken, bestanden te uploaden, ontvangers, bestandsverzoeken en ondertekeningsverzoeken te beheren en webhooks te ontvangen. Hij zit in de abonnementen Pro en Team.
Waar vind ik de API-documentatie?
De ontwikkelaarsgids staat op /developers en de volledige API-referentie met voorbeelden op /developers/api. Het machineleesbare OpenAPI 3.1-document is openbaar beschikbaar op /api/v1/openapi.json.
Gaan uploads verder als de verbinding wegvalt?
Ja. Bestanden worden geüpload met het tus-protocol voor hervatbare uploads, dus een onderbroken upload gaat verder waar hij stopte in plaats van opnieuw te beginnen.
Kan ik testen zonder echte e-mails te versturen?
Ja. Gebruik een testsleutel die begint met pf_test_. Testtransfers versturen nooit e-mails, tellen niet mee voor je opslag of gebruik en worden na 24 uur verwijderd.
Kan ik een bestand versturen dat al online staat?
Ja. POST /api/v1/transfers/from-url haalt bestanden op via HTTPS-URL's en maakt er een transfer van. Grotere imports lopen op de achtergrond door, en de webhook transfer.ready laat je weten wanneer de link klaar is.
Populair
- Goedkeuring van klanten op je bestanden
- Bestanden delen met je team
- Zien wie je bestanden heeft gedownload
- End-to-end versleuteld bestanden versturen
- Bestanden versturen voor fotografen, in volle kwaliteit
- Bestanden versturen voor videografen en editors
- Gratis bestanden versturen, tot 50 GB
- Grote bestanden versturen, gratis tot 50 GB
- Grote video's versturen in originele kwaliteit
- Verstuur gratis een bestand van 1 GB, in een paar tellen
- Grote bestanden versturen vanaf je iPhone, zonder app
- Pandafile vs WeTransfer: een eerlijke vergelijking