API-Dokumentation

Integrieren Sie mit unserer RESTful-API leistungsstarke Dateikonvertierung in Ihre Anwendung

Legen Sie loskeyHolen Sie sich den API-Schlüssel
bolt

Blitzschnell

Leistungsstarke Konvertierung mit optimierter Verarbeitung

shield

Sicher und zuverlässig

Sicherheit auf Unternehmensniveau mit 99,9 % Verfügbarkeit

trending_up

Skalierbar

Vom Prototyp bis zur Produktion skalieren wir mit Ihnen

terminalErste Schritte

Um die 1converter-API zu verwenden, befolgen Sie diese einfachen Schritte:

  1. Eröffnen Sie ein kostenloses Konto bei 1converter.com
  2. Generieren Sie einen API-Schlüssel aus Ihrem Dashboard
  3. Beginnen Sie mit dem Stellen von API-Anfragen mit Ihrem API-Schlüssel

keyAuthentifizierung

Alle API-Anfragen müssen Ihren API-Schlüssel im Authorization-Header enthalten:

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

Hinweis: Geben Sie Ihren API-Schlüssel niemals weiter und übergeben Sie ihn niemals der Versionskontrolle.

Bewahren Sie Ihren API-Schlüssel sicher auf und legen Sie ihn niemals im clientseitigen Code offen.

Basis-URL

Alle API-Anfragen sollten an Folgendes gerichtet werden:

https://api.1-converter.com/api/v1

OpenAPI 3.1 specification (JSON)

codeAPI-Endpunkte

Hochladen und konvertieren

Laden Sie eine Datei hoch und konvertieren Sie sie in das angegebene Format

POST/api/v1/convert/upload

Anforderungsheader

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Anfragetext

  • Die zu konvertierende Datei (erforderlich)
  • Zielformat (z. B. „pdf“, „jpg“, „png“) (erforderlich)

Antwort

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Überprüfen Sie den Status

Überprüfen Sie den Status einer Konvertierung

GET/api/v1/convert/status/:id

Antwort

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Ergebnis herunterladen

Laden Sie die konvertierte Datei herunter

GET/api/v1/convert/download/:id

Ratenbeschränkungen

API-Anfragen sind pro Minute begrenzt. Für den API-Zugriff ist ein kostenpflichtiger Tarif erforderlich:

PlanenRatenbegrenzung
FreiNicht verfügbar – Upgrade erforderlich
Anlasser5.000 Anfragen/Minute
Profi5.000 Anfragen/Minute
GeschäftUnbegrenzt

Wenn die Ratengrenzen überschritten werden, erhalten Sie die Antwort 429 Too Many Requests.

Fehlercodes

Die API verwendet Standard-HTTP-Statuscodes, um Erfolg oder Misserfolg anzuzeigen:

CodeBeschreibung
400 Ungültige AnfrageUngültige Anforderungsparameter
401 Nicht autorisiertUngültiger oder fehlender API-Schlüssel
403 VerbotenUnzureichende Berechtigungen
404 Nicht gefundenRessource nicht gefunden
429 Zu viele AnfragenRatenlimit überschritten
500 Interner ServerfehlerServerfehler, bitte versuchen Sie es erneut

integration_instructionsCodebeispiele

Hier sind Beispiele in verschiedenen Programmiersprachen:

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
 headers: {
 ...formData.getHeaders(),
 'Authorization': 'Bearer YOUR_API_KEY'
 }
}).then(response => {
 console.log(response.data);
}).catch(error => {
 console.error(error);
});

Python

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

cURL

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
 -H "X-API-Key: YOUR_API_KEY" \
 -F "[email protected]" \
 -F "target_format=png"

Brauchen Sie Hilfe?

Wenn Sie Fragen haben oder Hilfe zur API benötigen, sind wir für Sie da!

support_agentKontaktieren Sie den SupportkeyAPI-Schlüssel verwalten