API-Schlüssel, Zugriffsrechte und Testmodus

4 Min. Lesezeit · Aktualisiert am 2026-11-15

Kurze Antwort

Mit Pro und Team erstellst du API-Schlüssel unter Dashboard > Domain & API. Jeder Schlüssel hat einen Zugriff (Nur lesen, Lesen und Schreiben oder Vollzugriff) und einen Modus: Live-Schlüssel (pf_live_) arbeiten echt, Test-Schlüssel (pf_test_) mailen nie jemanden an, und ihre Übertragungen laufen nach 24 Stunden ab.

Mit der Pandafile-API können deine eigenen Apps, Skripte und Server Dateien senden, Uploads einsammeln und Unterschriften anfordern. Sie ist in Pro und Team enthalten und folgt denselben Grenzen wie die Website. Alles beginnt mit einem API-Schlüssel.

Einen Schlüssel erstellen

  1. Melde dich an und öffne Dashboard > Domain & API.
  2. Gib dem Schlüssel unter API-Schlüssel einen Namen, zum Beispiel Website-Uploads.
  3. Wähle den Schlüsselmodus, Live oder Test, und den Schlüsselzugriff: Vollzugriff, Lesen und Schreiben oder Nur lesen.
  4. Drücke auf Schlüssel erstellen und kopiere den Schlüssel sofort. Aus Sicherheitsgründen zeigen wir ihn nur einmal.
  5. Sende ihn bei jeder Anfrage im Header Authorization: Bearer, gefolgt vom Schlüssel.

Du kannst bis zu 10 aktive Schlüssel haben. Live-Schlüssel beginnen mit pf_live_, Test-Schlüssel mit pf_test_. Die Entwickleranleitung findest du unter pandafile.co/developers und die API-Referenz unter pandafile.co/developers/api.

Zugriffsrechte: was ein Schlüssel darf

  • Nur lesen: ausschließlich GET-Anfragen. Der Schlüssel kann Dinge abfragen, aber nichts ändern.
  • Lesen und Schreiben: alles aus Nur lesen, dazu Übertragungen, Dateianfragen, Signaturanfragen und Webhook-Abonnements erstellen, ändern und löschen.
  • Vollzugriff: alles, auch Kontoeinstellungen wie Branding und Team-Einladungen.

Testmodus

  • Übertragungen mit einem pf_test_-Schlüssel sind Testdaten. Es wird nie jemand angemailt, auch nicht Empfänger, die du hinzufügst.
  • Testübertragungen laufen immer 24 Stunden nach ihrer Erstellung ab und lassen sich nicht verlängern.
  • Sie zählen für keine Grenze, keinen Speicher und keine Nutzung und erscheinen nicht in deinen normalen Übertragungslisten.
  • Webhook-Ereignisse dazu haben livemode auf false und gehen nie an Slack, Microsoft Teams oder Discord.
  • Einige Aktionen funktionieren nur mit einem Live-Schlüssel. Mit einem Test-Schlüssel antwortet die API dann mit dem Fehler test_mode_unsupported.

Schlüssel sicher aufbewahren

  • Wer einen Schlüssel hat, kann Dateien von deinem Konto aus senden. Bewahre Schlüssel auf deinem Server auf, nie im öffentlichen Code einer Website oder App.
  • Widerrufe einen Schlüssel unter Dashboard > Domain & API, wenn er möglicherweise bekannt geworden ist. Apps, die ihn nutzen, funktionieren sofort nicht mehr, und Webhook-Abonnements, die damit angelegt wurden, etwa von Zapier oder Make, enden ebenfalls.
  • Jeder Schlüssel hat sein eigenes Ratenlimit. Jede Antwort zeigt in den RateLimit-Headern, wo du stehst.
  • In einem Team sind API-Schlüssel persönlich: Jedes Mitglied erstellt seine eigenen.
Bereit zum Senden?

Bis zu 50 GB pro Übertragung gratis, ohne Konto.

Dateien senden