Pandafile · 50 GB ilmaiseksi joka viikko

Tiedostonsiirron API sovelluksiisi ja työnkulkuihisi

Pandafilella on REST-API suurten tiedostojen lähettämiseen omasta koodistasi, palvelimiltasi ja no-code-työkaluista. Luo siirto, lähetä tiedostot katkoksista jatkuvalla lähetyksellä, lähetä vastaanottajille henkilökohtaiset linkit sähköpostilla ja saa webhook, kun joku lataa. API sisältyy Pro- ja Team-tilauksiin, noudattaa samoja rajoja kuin verkkosovellus ja on kuvattu julkisessa OpenAPI 3.1 -dokumentissa. Testiavaimilla voit rakentaa ja ajaa testejä lähettämättä oikeita sähköposteja tai käyttämättä tallennustilaasi.

Lue kehittäjäopas

REST-API ja OpenAPI 3.1 -kuvaus

Kaikki päätepisteet ovat polun /api/v1 alla ja käyttävät JSONia. Todennus tehdään API-avaimella, joka annetaan Authorization-otsakkeessa Bearer-tunnisteena. Avaimet luodaan hallintapaneelissa, ne näytetään vain kerran, ja ne voi rajata pelkkään lukuun, lukuun ja kirjoitukseen tai täyteen käyttöoikeuteen, joten raportointiskripti ei koskaan saa oikeutta poistaa siirtoja. Koko API on kuvattu koneluettavassa OpenAPI 3.1 -dokumentissa osoitteessa /api/v1/openapi.json. Sen voi tuoda Postmaniin, siitä voi generoida asiakaskirjaston tai sen voi antaa tekoälykoodausavustajalle. Kehittäjäopas osoitteessa /developers selittää käsitteet, ja API-viite osoitteessa /developers/api listaa kaikki päätepisteet esimerkkeineen. Jokaisessa vastauksessa on pyynnön tunniste, pyyntörajat ilmoitetaan RateLimit-otsakkeissa, listat käyttävät kursoripohjaista sivutusta ja kaikilla virheillä on sama JSON-muoto.

Katkoksista jatkuvat lähetykset tus-protokollalla

Suuret tiedostot ja epävakaat verkot eivät sovi hyvin yhteen yhden pitkän HTTP-pyynnön kanssa. Tiedostoja lähettääksesi luot ensin siirron kutsulla POST /api/v1/transfers ja annat tiedostot, otsikon, viestin ja halutessasi vastaanottajien sähköpostiosoitteet. Jokainen tiedosto lähetetään sitten tus-protokollalla, joka on avoin protokolla katkoksista jatkuville lähetyksille. Näin katkennut yhteys tai uudelleen käynnistetty palvelin voi jatkaa viimeisestä tavusta aloittamatta alusta. Valmiita tus-asiakkaita on saatavilla JavaScriptille, Pythonille, Golle, Javalle, .NETille, Swiftille ja monille muille. Kun kaikki tiedostot ovat perillä, kutsut complete-toimintoa, ja siirrosta tulee tavallinen Pandafile-linkki, jossa on lataussivu, vastaanottajien henkilökohtaiset linkit, muistutukset ja vanhenemispäivä. Samat tilausrajat pätevät kuin selaimessa: jopa 1000 GB siirtoa kohden ja 1500 GB tallennustilaa Prossa.

Lähetä tiedostot suoraan URL-osoitteesta

Joskus tiedosto on jo muualla: CRM-järjestelmän liitteenä, renderöintifarmin tuloksena tai vientinä toisella palvelimella. POST /api/v1/transfers/from-url ottaa vastaan HTTPS-osoitteita ja antaa Pandafilen hakea tiedostot puolestasi, minkä jälkeen se luo ja viimeistelee siirron. Pyyntö odottaa enintään 20 sekuntia. Pienet tuonnit palaavat valmiina, ja suuremmat vastaavat heti tilalla uploading, kun tuonti jatkuu taustalla. Voit seurata edistymistä kutsulla GET /api/v1/transfers/{id}/import tai yksinkertaisesti odottaa transfer.ready-webhookia. Näin myös Zapier- ja Make-integraatiot lähettävät tiedostoja ilman, että työnkulun tarvitsee ensin ladata ne.

Webhookit ja ilmoitukset

Jatkuvan kyselyn sijaan voit tilata tapahtumia. Pandafile voi kutsua URL-osoitettasi, kun siirto on valmis, ladattu tai vanhentunut, kun vastaanottaja hyväksyy tiedostot tai pyytää muutoksia, kun joku lähettää tiedostoja johonkin tiedostopyyntöösi ja kun allekirjoituspyyntö on valmis. Jokainen toimitus allekirjoitetaan HMAC-SHA256:lla Pandafile-Signature-otsakkeessa, joten voit tarkistaa, että se todella tuli meiltä. Epäonnistuneet toimitukset yritetään uudelleen 1 minuutin, 5 minuutin, 30 minuutin, 2 tunnin ja 12 tunnin kuluttua. Tapahtumat säilytetään myös 30 päivää, ja ne voi lukea kutsulla GET /api/v1/events. Jos et tarvitse koodia lainkaan, samat tapahtumat voivat lähettää viestejä Slackiin, Microsoft Teamsiin tai Discordiin.

Testiavaimet, turvalliset uusintayritykset ja muu automatisointi

API-avaimia on kahta tyyppiä. Live-avaimet alkavat pf_live_ ja testiavaimet pf_test_. Testiavaimella tehdyt siirrot eivät koskaan lähetä sähköpostia eivätkä kuluta tallennustilaasi tai käyttökiintiötäsi, ne säilytetään vain 24 tuntia eivätkä ne näy tavallisessa siirtoluettelossasi. Voit siis ajaa integraatiotestejä oikeaa APIa vastaan ilman sivuvaikutuksia. POST- ja PATCH-pyynnöt hyväksyvät Idempotency-Key-otsakkeen, joten uudelleen lähetetty pyyntö ei koskaan luo toista siirtoa. Siirtojen lisäksi API kattaa vastaanottajat ja muistutukset, lataushistorian, linkkitilastot ja hyväksynnät, tiedostopyynnöt, allekirjoituspyynnöt, brändäyksen ja tiimikutsut. API sisältyy Prohon, alkaen $5.99 kuukaudessa tai $49.99 vuodessa, ja Teamiin, alkaen $14.99 kuukaudessa tai $129.99 vuodessa. Tiimissä jokaisella jäsenellä on omat henkilökohtaiset avaimensa.

Kysymyksiä

Onko Pandafilella API?

On. Pandafilella on REST-API polussa /api/v1 siirtojen luomiseen, tiedostojen lähettämiseen, vastaanottajien, tiedostopyyntöjen ja allekirjoituspyyntöjen hallintaan sekä webhookien vastaanottamiseen. Se sisältyy Pro- ja Team-tilauksiin.

Mistä löydän API-dokumentaation?

Kehittäjäopas on osoitteessa /developers ja täydellinen API-viite esimerkkeineen osoitteessa /developers/api. Koneluettava OpenAPI 3.1 -dokumentti on julkisesti saatavilla osoitteessa /api/v1/openapi.json.

Jatkuuko lähetys, jos yhteys katkeaa?

Kyllä. Tiedostot lähetetään tus-protokollalla, joka on tehty katkoksista jatkuviin lähetyksiin, joten keskeytynyt lähetys jatkuu siitä, mihin se jäi, eikä ala alusta.

Voinko testata lähettämättä oikeita sähköposteja?

Kyllä. Käytä testiavainta, joka alkaa pf_test_. Testisiirrot eivät koskaan lähetä sähköpostia, eivät kuluta tallennustilaasi tai käyttökiintiötäsi, ja ne poistetaan 24 tunnin kuluttua.

Voinko lähettää tiedoston, joka on jo verkossa?

Kyllä. POST /api/v1/transfers/from-url hakee tiedostot HTTPS-osoitteista ja tekee niistä siirron. Suuremmat tuonnit jatkuvat taustalla, ja transfer.ready-webhook kertoo, kun linkki on valmis.

Lue kehittäjäopas

Suositut