Pandafile · 50 GB zdarma každý týden

API pro přenos souborů pro vaše aplikace a procesy

Pandafile má REST API pro posílání velkých souborů z vašeho vlastního kódu, serverů a no-code nástrojů. Vytvořte přenos, nahrajte soubory s obnovitelným nahráváním, pošlete příjemcům osobní odkazy e-mailem a dostaňte webhook, když si někdo soubory stáhne. API je součástí Pro a Team, řídí se stejnými limity jako webová aplikace a je popsané ve veřejném dokumentu OpenAPI 3.1. Testovací klíče vám umožní vyvíjet a spouštět testy bez odesílání skutečných e-mailů a bez čerpání úložiště.

Přečíst příručku pro vývojáře

REST API s popisem v OpenAPI 3.1

Všechny endpointy jsou pod /api/v1 a komunikují v JSON. Ověřujete se API klíčem v hlavičce Authorization jako Bearer token. Klíče vytvoříte v přehledu, zobrazí se jen jednou a můžete je omezit na pouhé čtení, čtení a zápis, nebo plný přístup, takže skript pro reporty nikdy nedostane oprávnění mazat přenosy. Celé API popisuje strojově čitelný dokument OpenAPI 3.1 na /api/v1/openapi.json, který můžete načíst do Postmanu, vygenerovat z něj klienta nebo ho předat AI asistentovi pro programování. Příručka pro vývojáře na /developers vysvětluje základní pojmy a reference API na /developers/api uvádí každý endpoint s příklady. Každá odpověď nese ID požadavku, limity požadavků se hlásí v hlavičkách RateLimit, seznamy používají stránkování kurzorem a chyby mají jednotný formát JSON.

Obnovitelné nahrávání přes tus

Velké soubory a nespolehlivé sítě se s jedním dlouhým HTTP požadavkem moc nesnesou. Chcete-li poslat soubory, nejprve vytvoříte přenos pomocí POST /api/v1/transfers, kde uvedete soubory, nadpis, zprávu a případně e-mailové adresy příjemců. Každý soubor se pak nahraje přes tus, otevřený protokol pro obnovitelné nahrávání, takže po výpadku připojení nebo restartu serveru může nahrávání pokračovat od posledního bajtu, místo aby začínalo znovu. Hotoví klienti pro tus existují pro JavaScript, Python, Go, Javu, .NET, Swift a další jazyky. Když jsou všechny soubory nahrané, zavoláte complete a z přenosu se stane běžný odkaz Pandafile se stránkou ke stažení, osobními odkazy pro příjemce, připomínkami a vypršením. Platí stejné limity tarifu jako v prohlížeči: v Pro až 1000 GB v jednom přenosu a 1500 GB úložiště.

Posílejte soubory přímo z URL

Někdy už soubor leží jinde: příloha v CRM, výstup z renderovací farmy nebo export na jiném serveru. POST /api/v1/transfers/from-url přijme adresy URL s HTTPS, Pandafile soubory stáhne za vás a pak přenos vytvoří a dokončí. Požadavek čeká až 20 sekund. Malé importy se vrátí hotové, větší se vrátí hned se stavem uploading a import pokračuje na pozadí. Průběh můžete sledovat přes GET /api/v1/transfers/{id}/import, nebo jednoduše počkat na webhook transfer.ready. Právě takto posílají soubory i integrace se Zapierem a Make, aniž by je váš workflow musel nejdřív stáhnout.

Webhooky a upozornění

Místo opakovaného dotazování se přihlaste k odběru událostí. Pandafile může zavolat vaši URL, když je přenos připravený, stažený nebo vypršel, když příjemce soubory schválí nebo požádá o změny, když vám někdo nahraje soubory do žádosti o soubory a když je dokončena žádost o podpis. Každé doručení je podepsané pomocí HMAC-SHA256 v hlavičce Pandafile-Signature, takže si můžete ověřit, že opravdu přišlo od nás, a neúspěšná doručení se opakují po 1 minutě, 5 minutách, 30 minutách, 2 hodinách a 12 hodinách. Události se také uchovávají 30 dní a můžete je číst přes GET /api/v1/events. Pokud kód vůbec nepotřebujete, stejné události mohou posílat zprávy do Slacku, Microsoft Teams nebo Discordu.

Testovací klíče, bezpečné opakování a co dalšího lze automatizovat

API klíče mají dva režimy. Ostré klíče začínají na pf_live_ a testovací na pf_test_. Přenosy vytvořené testovacím klíčem nikdy neposílají e-maily, nezapočítávají se do úložiště ani využití, uchovávají se jen 24 hodin a nezobrazují se v běžném seznamu přenosů, takže můžete proti skutečnému API spouštět integrační testy bez vedlejších účinků. Požadavky POST a PATCH přijímají hlavičku Idempotency-Key, takže opakovaný požadavek nikdy nevytvoří druhý přenos. Kromě přenosů API pokrývá příjemce a připomínky, historii stažení, statistiky odkazů a schválení, žádosti o soubory, žádosti o podpis, branding a pozvánky do týmu. API je součástí Pro od $5.99 měsíčně nebo $49.99 ročně a Team od $14.99 měsíčně nebo $129.99 ročně. V týmu má každý člen vlastní osobní klíče.

Otázky

Má Pandafile API?

Ano. Pandafile má REST API pod /api/v1 pro vytváření přenosů, nahrávání souborů, správu příjemců, žádostí o soubory a žádostí o podpis a pro příjem webhooků. Je součástí tarifů Pro a Team.

Kde najdu dokumentaci API?

Příručka pro vývojáře je na /developers a kompletní reference API s příklady na /developers/api. Strojově čitelný dokument OpenAPI 3.1 je veřejně dostupný na /api/v1/openapi.json.

Pokračuje nahrávání po výpadku připojení?

Ano. Soubory se nahrávají přes protokol tus pro obnovitelné nahrávání, takže přerušené nahrávání pokračuje tam, kde skončilo, místo aby začínalo od začátku.

Můžu testovat bez odesílání skutečných e-mailů?

Ano. Použijte testovací klíč, který začíná na pf_test_. Testovací přenosy nikdy neposílají e-maily, nezapočítávají se do úložiště ani využití a po 24 hodinách se smažou.

Můžu poslat soubor, který už je online?

Ano. POST /api/v1/transfers/from-url stáhne soubory z adres URL s HTTPS a udělá z nich přenos. Větší importy pokračují na pozadí a webhook transfer.ready vám dá vědět, až bude odkaz připravený.

Přečíst příručku pro vývojáře

Oblíbené