API-avaimet, käyttöoikeudet ja testitila

4 min lukuaika · Päivitetty 2026-11-15

Lyhyt vastaus

Pro- ja Team-tilauksissa luot API-avaimet kohdassa Hallintapaneeli > Verkkotunnus ja API. Jokaisella avaimella on käyttöoikeus (Vain luku, Luku ja kirjoitus tai Täydet oikeudet) ja tila: tuotantoavaimet (pf_live_) toimivat oikeasti, testiavaimet (pf_test_) eivät koskaan lähetä sähköpostia kenellekään, ja niiden siirrot vanhenevat 24 tunnissa.

Pandafilen API:n avulla omat sovelluksesi, skriptisi ja palvelimesi voivat lähettää tiedostoja, kerätä latauksia ja pyytää allekirjoituksia. Se sisältyy Pro- ja Team-tilauksiin ja noudattaa samoja rajoja kuin verkkosivusto. Kaikki alkaa API-avaimesta.

Luo avain

  1. Kirjaudu sisään ja avaa Hallintapaneeli > Verkkotunnus ja API.
  2. Anna avaimelle nimi kohdassa API-avaimet, esimerkiksi Verkkosivun lataukset.
  3. Valitse avaimen tila, Tuotanto tai Testi, ja avaimen käyttöoikeus: Täydet oikeudet, Luku ja kirjoitus tai Vain luku.
  4. Paina Luo avain ja kopioi avain heti. Turvallisuussyistä näytämme sen vain kerran.
  5. Lähetä se jokaisen pyynnön mukana otsakkeessa Authorization: Bearer ja sen perässä avain.

Aktiivisia avaimia voi olla enintään 10. Tuotantoavaimet alkavat merkeillä pf_live_ ja testiavaimet merkeillä pf_test_. Kehittäjäopas on osoitteessa pandafile.co/developers ja API-viite osoitteessa pandafile.co/developers/api.

Käyttöoikeudet: mitä avain saa tehdä

  • Vain luku: vain GET-pyynnöt. Avain voi hakea tietoja, mutta ei muuttaa mitään.
  • Luku ja kirjoitus: kaikki Vain luku -oikeuden asiat sekä siirtojen, tiedostopyyntöjen, allekirjoituspyyntöjen ja webhook-tilausten luominen, muuttaminen ja poistaminen.
  • Täydet oikeudet: kaikki, myös tilin asetukset, kuten brändäys ja tiimikutsut.

Testitila

  • pf_test_-avaimella tehdyt siirrot ovat testidataa. Kenellekään ei koskaan lähetetä sähköpostia, ei edes lisäämillesi vastaanottajille.
  • Testisiirrot vanhenevat aina 24 tunnin kuluttua luomisesta, eikä niitä voi jatkaa.
  • Ne eivät kerrytä mitään rajaa, tallennustilaa tai käyttöä, eivätkä ne näy tavallisissa siirtolistoissasi.
  • Niitä koskevissa webhook-tapahtumissa livemode on false, eivätkä ne koskaan mene Slackiin, Microsoft Teamsiin tai Discordiin.
  • Muutama toiminto toimii vain tuotantoavaimella. Testiavaimella API vastaa silloin virheellä test_mode_unsupported.

Pidä avaimet turvassa

  • Kuka tahansa, jolla on avain, voi lähettää tiedostoja tililtäsi. Säilytä avaimet palvelimellasi, älä koskaan verkkosivuston tai sovelluksen julkisessa koodissa.
  • Peru avain kohdassa Hallintapaneeli > Verkkotunnus ja API, jos se on voinut vuotaa. Sitä käyttävät sovellukset lakkaavat toimimasta heti, ja myös sillä tehdyt webhook-tilaukset, esimerkiksi Zapierin tai Maken tekemät, pysähtyvät.
  • Jokaisella avaimella on oma pyyntörajansa. Jokainen vastaus kertoo tilanteesi RateLimit-otsakkeissa.
  • Tiimissä API-avaimet ovat henkilökohtaisia: jokainen jäsen luo omansa.
Valmis lähettämään?

Jopa 50 GB ilmaiseksi per siirto, ilman tiliä.

Lähetä tiedostoja