Pandafile · 50 GB za darmo co tydzień

API do przesyłania plików dla Twoich aplikacji i automatyzacji

Pandafile ma REST API do wysyłania dużych plików z własnego kodu, serwerów i narzędzi no-code. Utwórz transfer, wyślij pliki z możliwością wznawiania, roześlij odbiorcom osobiste linki e-mailem i odbierz webhook, gdy ktoś pobierze pliki. API jest częścią planów Pro i Team, ma te same limity co aplikacja webowa i jest opisane w publicznym dokumencie OpenAPI 3.1. Klucze testowe pozwalają budować i uruchamiać testy bez wysyłania prawdziwych e-maili i bez zużywania Twojej przestrzeni.

Przeczytaj przewodnik dla deweloperów

REST API z opisem OpenAPI 3.1

Wszystkie endpointy znajdują się pod /api/v1 i komunikują się w formacie JSON. Uwierzytelniasz się kluczem API w nagłówku Authorization jako tokenem Bearer. Klucze tworzysz w panelu, są wyświetlane tylko raz i można je ograniczyć do samego odczytu, odczytu i zapisu albo pełnego dostępu, dzięki czemu skrypt raportowy nigdy nie dostanie uprawnień do usuwania transferów. Całe API opisuje maszynowo czytelny dokument OpenAPI 3.1 pod adresem /api/v1/openapi.json, który możesz wczytać do Postmana, wygenerować z niego klienta albo przekazać asystentowi AI do programowania. Przewodnik dla deweloperów pod /developers wyjaśnia podstawowe pojęcia, a dokumentacja API pod /developers/api opisuje każdy endpoint z przykładami. Każda odpowiedź zawiera identyfikator żądania, limity zapytań są podawane w nagłówkach RateLimit, listy używają paginacji kursorowej, a wszystkie błędy mają jeden format JSON.

Wznawialne wysyłanie przez tus

Duże pliki i niestabilne sieci źle znoszą jedno długie żądanie HTTP. Aby wysłać pliki, najpierw tworzysz transfer przez POST /api/v1/transfers, podając pliki, tytuł, wiadomość i opcjonalnie adresy e-mail odbiorców. Następnie każdy plik jest wysyłany przez tus, otwarty protokół wznawialnego wysyłania, więc zerwane połączenie lub restart serwera pozwala kontynuować od ostatniego bajtu zamiast zaczynać od nowa. Gotowe klienty tus są dostępne dla JavaScriptu, Pythona, Go, Javy, .NET, Swifta i innych. Gdy wszystkie pliki są na miejscu, wywołujesz complete, a transfer staje się zwykłym linkiem Pandafile ze stroną pobierania, osobistymi linkami dla odbiorców, przypomnieniami i datą wygaśnięcia. Obowiązują te same limity planu co w przeglądarce: do 1000 GB w jednym transferze i 1500 GB przestrzeni w Pro.

Wysyłaj pliki prosto z adresu URL

Czasem plik jest już gdzie indziej: jako załącznik w CRM, wynik z farmy renderującej albo eksport na innym serwerze. POST /api/v1/transfers/from-url przyjmuje adresy HTTPS i pozwala Pandafile pobrać pliki za Ciebie, a potem tworzy i finalizuje transfer. Żądanie czeka do 20 sekund. Małe importy wracają gotowe, a większe od razu zwracają status uploading, podczas gdy import trwa dalej w tle. Postęp możesz śledzić przez GET /api/v1/transfers/{id}/import albo po prostu poczekać na webhook transfer.ready. W ten sam sposób integracje z Zapierem i Make wysyłają pliki, bez konieczności wcześniejszego pobierania ich przez Twoją automatyzację.

Webhooki i powiadomienia

Zamiast ciągle odpytywać API, zasubskrybuj zdarzenia. Pandafile może wywołać Twój adres URL, gdy transfer jest gotowy, pobrany lub wygasł, gdy odbiorca zaakceptuje pliki albo poprosi o zmiany, gdy ktoś wgra pliki przez jedną z Twoich próśb o pliki i gdy prośba o podpis zostanie zakończona. Każde doręczenie jest podpisane HMAC-SHA256 w nagłówku Pandafile-Signature, więc możesz sprawdzić, że naprawdę pochodzi od nas, a nieudane doręczenia są ponawiane po 1 minucie, 5 minutach, 30 minutach, 2 godzinach i 12 godzinach. Zdarzenia są też przechowywane przez 30 dni i można je odczytać przez GET /api/v1/events. Jeśli w ogóle nie potrzebujesz kodu, te same zdarzenia mogą wysyłać wiadomości do Slacka, Microsoft Teams lub Discorda.

Klucze testowe, bezpieczne ponawianie i co jeszcze zautomatyzujesz

Klucze API działają w dwóch trybach. Klucze produkcyjne zaczynają się od pf_live_, a testowe od pf_test_. Transfery utworzone kluczem testowym nigdy nie wysyłają e-maili, nie zużywają Twojej przestrzeni ani limitów, są przechowywane tylko przez 24 godziny i nie pojawiają się na zwykłej liście transferów, więc możesz uruchamiać testy integracyjne na prawdziwym API bez skutków ubocznych. Żądania POST i PATCH akceptują nagłówek Idempotency-Key, więc ponowione żądanie nigdy nie utworzy drugiego transferu. Poza transferami API obejmuje odbiorców i przypomnienia, historię pobrań, statystyki linków i akceptacje, prośby o pliki, prośby o podpis, branding oraz zaproszenia do zespołu. API jest dostępne w Pro, od 5,99 $ miesięcznie lub 49,99 $ rocznie, oraz w Team, od 14,99 $ miesięcznie lub 129,99 $ rocznie. W zespole każdy członek ma własne, osobiste klucze.

Pytania

Czy Pandafile ma API?

Tak. Pandafile ma REST API pod /api/v1 do tworzenia transferów, wysyłania plików, zarządzania odbiorcami, prośbami o pliki i prośbami o podpis oraz do odbierania webhooków. Jest dostępne w planach Pro i Team.

Gdzie jest dokumentacja API?

Przewodnik dla deweloperów znajdziesz pod /developers, a pełną dokumentację API z przykładami pod /developers/api. Maszynowo czytelny dokument OpenAPI 3.1 jest publicznie dostępny pod /api/v1/openapi.json.

Czy wysyłanie można wznowić po zerwaniu połączenia?

Tak. Pliki są wysyłane przez protokół tus do wznawialnego wysyłania, więc przerwane wysyłanie jest kontynuowane od miejsca, w którym się zatrzymało, zamiast zaczynać od nowa.

Czy mogę testować bez wysyłania prawdziwych e-maili?

Tak. Użyj klucza testowego zaczynającego się od pf_test_. Transfery testowe nigdy nie wysyłają e-maili, nie zużywają Twojej przestrzeni ani limitów i są usuwane po 24 godzinach.

Czy mogę wysłać plik, który jest już w sieci?

Tak. POST /api/v1/transfers/from-url pobiera pliki z adresów HTTPS i tworzy z nich transfer. Większe importy trwają dalej w tle, a webhook transfer.ready informuje, kiedy link jest gotowy.

Przeczytaj przewodnik dla deweloperów

Popularne