API-Dokumentation

Wandeln Sie Dateien aus Ihrem eigenen Code um: Datei hochladen, Status abfragen, Ergebnis herunterladen. Drei Anfragen und ein API-Schlüssel.

Holen Sie sich den API-SchlüsselLegen Sie los
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"

Erste Schritte

Von null zur ersten umgewandelten Datei:

  1. Wählen Sie auf 1-converter.com einen bezahlten Tarif (Starter, Pro oder Business). Mit Free gibt es keine API-Schlüssel.
  2. Erstellen Sie unter „Dashboard → Einstellungen → API-Schlüssel“ einen Schlüssel und kopieren Sie ihn: Er wird nur einmal angezeigt.
  3. Senden Sie den Schlüssel mit dem ersten Upload, wie unter „Authentifizierung“ gezeigt.

Authentifizierung

Senden Sie Ihren API-Schlüssel mit jeder Anfrage, in einem dieser beiden Header:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Beide Header werden akzeptiert und tragen denselben Schlüssel. Nehmen Sie den, der für Ihren HTTP-Client einfacher ist.

Geben Sie Ihren API-Schlüssel nie weiter und committen Sie ihn nie in die Versionsverwaltung.

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 (openapi.json)

API-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

  • fileDie zu konvertierende Datei (erforderlich)
  • target_formatZielformat (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

Jeder bezahlte Tarif enthält ein monatliches Kontingent an API-Aufrufen, dasselbe wie auf der Preisseite.

PlanenAPI-Aufrufe pro Monat
FreeKeine API-Schlüssel
Starter1.000 API-Aufrufe pro Monat
Pro10.000 API-Aufrufe pro Monat
BusinessAPI unbegrenzt

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

Codebeispiele

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?

Eine Anfrage scheitert auf eine Weise, die diese Doku nicht erklärt? Schreiben Sie uns mit der Anfrage und der Antwort, die Sie bekommen haben.

Kontaktieren Sie den SupportAPI-Schlüssel verwalten