Pandafile · Hetente 50 GB ingyen
Fájlküldő API az alkalmazásaidhoz és munkafolyamataidhoz
A Pandafile REST API-jával nagy fájlokat küldhetsz a saját kódodból, szervereidről és no-code eszközeidből. Hozz létre egy küldést, töltsd fel a fájlokat folytatható feltöltéssel, küldj személyes linkeket e-mailben a címzetteknek, és kapj webhookot, amikor valaki letölti őket. Az API a Pro és a Team része, ugyanazok a korlátok vonatkoznak rá, mint a webes alkalmazásra, és egy nyilvános OpenAPI 3.1 dokumentum írja le. A tesztkulcsokkal úgy fejleszthetsz és futtathatsz teszteket, hogy nem mennek ki valódi e-mailek, és nem fogy a tárhelyed.
REST API OpenAPI 3.1 leírással
Minden végpont a /api/v1 alatt található, és JSON-t használ. A hitelesítés API-kulccsal történik az Authorization fejlécben, Bearer tokenként. A kulcsokat az irányítópulton hozod létre, csak egyszer jelennek meg, és korlátozhatod őket csak olvasásra, olvasásra és írásra vagy teljes hozzáférésre, így egy riportkészítő szkript sosem kap jogot küldések törlésére. A teljes API-t egy géppel olvasható OpenAPI 3.1 dokumentum írja le a /api/v1/openapi.json címen, amelyet betölthetsz a Postmanbe, generálhatsz belőle klienst, vagy odaadhatod egy AI-alapú kódolóasszisztensnek. A /developers oldalon lévő fejlesztői útmutató elmagyarázza az alapfogalmakat, a /developers/api oldalon lévő API-referencia pedig példákkal mutat be minden végpontot. Minden válasz tartalmaz egy kérésazonosítót, a sebességkorlátokat RateLimit fejlécek jelzik, a listák kurzoros lapozást használnak, a hibák pedig egységes JSON-formátumot követnek.
Folytatható feltöltés tus-szal
A nagy fájlok és a megbízhatatlan hálózatok nem igazán férnek össze egyetlen hosszú HTTP-kéréssel. Fájlok küldéséhez először létrehozol egy küldést a POST /api/v1/transfers végponttal, megadva a fájlokat, a címet, az üzenetet és, ha szeretnéd, a címzettek e-mail-címét. Ezután minden fájl tus-szal, a folytatható feltöltések nyílt protokolljával töltődik fel, így egy megszakadt kapcsolat vagy újraindított szerver után a feltöltés az utolsó bájttól folytatódik, nem kezdődik elölről. Kész tus-kliensek léteznek JavaScripthez, Pythonhoz, Góhoz, Javához, .NET-hez, Swifthez és más nyelvekhez. Amikor minden fájl feltöltődött, meghívod a complete végpontot, és a küldésből normál Pandafile-link lesz letöltési oldallal, személyes linkekkel a címzetteknek, emlékeztetőkkel és lejárattal. Ugyanazok a csomagkorlátok érvényesek, mint a böngészőben: a Próval küldésenként akár 1000 GB és 1500 GB tárhely.
Küldj fájlokat közvetlenül URL-ről
Néha a fájl már máshol van: egy CRM-mellékletben, egy renderfarm kimenetében vagy egy másik szerveren lévő exportban. A POST /api/v1/transfers/from-url HTTPS URL-eket fogad, a Pandafile letölti helyetted a fájlokat, majd létrehozza és lezárja a küldést. A kérés legfeljebb 20 másodpercig vár. A kis importok készen térnek vissza, a nagyobbak azonnal válaszolnak uploading állapottal, az import pedig a háttérben folytatódik. A folyamatot a GET /api/v1/transfers/{id}/import végponttal követheted, vagy egyszerűen megvárhatod a transfer.ready webhookot. A Zapier- és Make-integrációk is így küldenek fájlokat anélkül, hogy a munkafolyamatodnak előbb le kellene töltenie őket.
Webhookok és értesítések
Folyamatos lekérdezés helyett iratkozz fel eseményekre. A Pandafile meghívhatja az URL-edet, amikor egy küldés elkészült, letöltötték vagy lejárt, amikor egy címzett jóváhagyja a fájlokat vagy módosítást kér, amikor valaki feltölt az egyik fájlkérésedbe, és amikor egy aláírási kérés teljesül. Minden kézbesítést HMAC-SHA256 aláírás véd a Pandafile-Signature fejlécben, így ellenőrizheted, hogy tényleg tőlünk jött, a sikertelen kézbesítéseket pedig 1 perc, 5 perc, 30 perc, 2 óra és 12 óra után újrapróbáljuk. Az eseményeket 30 napig meg is őrizzük, és a GET /api/v1/events végponttal olvashatod ki őket. Ha egyáltalán nincs szükséged kódra, ugyanezek az események üzenetet küldhetnek a Slackbe, a Microsoft Teamsbe vagy a Discordba.
Tesztkulcsok, biztonságos újrapróbálkozás és további automatizálás
Az API-kulcsoknak két módjuk van. Az éles kulcsok pf_live_, a tesztkulcsok pf_test_ előtaggal kezdődnek. A tesztkulccsal létrehozott küldések soha nem küldenek e-mailt, nem számítanak bele a tárhelyedbe és a használatodba, csak 24 óráig maradnak meg, és nem jelennek meg a szokásos küldéslistádban, így mellékhatások nélkül futtathatsz integrációs teszteket a valódi API-val szemben. A POST és PATCH kérések elfogadnak egy Idempotency-Key fejlécet, így egy megismételt kérés soha nem hoz létre második küldést. A küldéseken túl az API lefedi a címzetteket és emlékeztetőket, a letöltési előzményeket, a link-statisztikát és a jóváhagyásokat, a fájlkéréseket, az aláírási kéréseket, az arculatot és a csapatmeghívókat. Az API a Pro része havi $5.99-tól vagy évi $49.99-tól, és a Teamé havi $14.99-tól vagy évi $129.99-tól. Egy csapatban minden tagnak saját, személyes kulcsai vannak.
Fejlesztői útmutató · API-referencia · OpenAPI 3.1 dokumentum
Kérdések
Van a Pandafile-nak API-ja?
Igen. A Pandafile REST API-ja a /api/v1 alatt érhető el küldések létrehozásához, fájlok feltöltéséhez, címzettek, fájlkérések és aláírási kérések kezeléséhez, valamint webhookok fogadásához. A Pro és a Team csomag része.
Hol található az API dokumentációja?
A fejlesztői útmutató a /developers oldalon, a teljes, példákkal ellátott API-referencia a /developers/api oldalon van. A géppel olvasható OpenAPI 3.1 dokumentum nyilvánosan elérhető a /api/v1/openapi.json címen.
Folytatódik a feltöltés, ha megszakad a kapcsolat?
Igen. A fájlok a folytatható feltöltésekhez készült tus protokollal töltődnek fel, így egy megszakadt feltöltés ott folytatódik, ahol abbamaradt, és nem kezdődik elölről.
Tesztelhetek valódi e-mailek küldése nélkül?
Igen. Használj pf_test_ kezdetű tesztkulcsot. A tesztküldések soha nem küldenek e-mailt, nem számítanak bele a tárhelyedbe és a használatodba, és 24 óra után törlődnek.
Elküldhetek egy már online lévő fájlt?
Igen. A POST /api/v1/transfers/from-url HTTPS URL-ekről tölti le a fájlokat, és küldést készít belőlük. A nagyobb importok a háttérben folytatódnak, a transfer.ready webhook pedig jelzi, amikor a link elkészült.
Olvasd el a fejlesztői útmutatót
Népszerű
- Ügyfél-jóváhagyás a fájljaidra
- Fájlmegosztás csapatoknak
- Nézd meg, ki töltötte le a fájljaidat
- Végponttól végpontig titkosított fájlküldés
- Fájlküldés fotósoknak, teljes minőségben
- Fájlküldés videósoknak és vágóknak
- Ingyenes fájlküldés akár 50 GB-ig, fiók nélkül
- Nagy fájlok küldése ingyen, akár 50 GB-ig
- Nagy videófájlok küldése teljes minőségben
- 1 GB-os fájl küldése ingyen, másodpercek alatt
- Nagy fájlok küldése iPhone-ról, alkalmazás nélkül
- Pandafile vs WeTransfer: őszinte összehasonlítás