API DOKUMENTATION

REST API für programmatischen Zugriff auf alle LoadSh.it Services

v1.0

Einführung

Die LoadSh.it API ermöglicht programmatischen Zugriff auf alle Kernfunktionen: Dateikonvertierung, Sicherheits-Scans und Audio/Video Transkription.

80+ Formate

Video, Audio, Bilder, Dokumente

ClamAV Scan

Enterprise Virenschutz

Whisper AI

Transkription in 99 Sprachen

Authentifizierung

Alle API-Anfragen benötigen einen gültigen API Key im Authorization Header. API Keys können in den Einstellungen erstellt werden.

HTTP HEADER

Authorization: Bearer lsh_live_xxxxxxxxxxxxxxxxxxxxxxxx

Wichtig: Speichere deinen API Key sicher. Er wird nur einmal bei der Erstellung angezeigt und kann nicht wiederhergestellt werden.

Base URL

https://loadsh.it/api

Alle Endpoints sind relativ zu dieser Base URL.

Rate Limits

Die API hat derzeit keine strikten Rate Limits für authentifizierte Benutzer. Wir behalten uns vor, bei Missbrauch Limits einzuführen.

Requests/Min	Max Dateigrösse
Unlimited	5 GB

Endpoints

POST /api/convert

Datei konvertieren

Konvertiert eine Datei in ein anderes Format. Unterstützt Video, Audio, Bilder und Dokumente.

Parameter

Name	Typ	Beschreibung
`file` required	File	Die zu konvertierende Datei (multipart/form-data)
`target_format` required	string	Zielformat (z.B. "mp4", "pdf", "png")
`processing_mode`	string	"auto" \| "force_cpu" \| "force_gpu"

Beispiele

cURL

BASH

curl -X POST "https://loadsh.it/api/convert" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -F "[email protected]" \
  -F "target_format=mp4"

JavaScript

JAVASCRIPT

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('target_format', 'mp4');

const response = await fetch(
  'https://loadsh.it/api/convert',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' },
    body: formData
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "job_id": "conv_abc123",
  "status": "processing"
}

POST /api/scan

Sicherheits-Scan

Scannt eine Datei auf Viren, Malware und andere Bedrohungen mit ClamAV & YARA Rules.

Parameter

Name	Typ	Beschreibung
`file` required	File	Die zu scannende Datei (multipart/form-data)

Beispiele

cURL

BASH

curl -X POST "https://loadsh.it/api/scan" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -F "[email protected]"

JavaScript

JAVASCRIPT

const formData = new FormData();
formData.append('file', fileInput.files[0]);

const response = await fetch(
  'https://loadsh.it/api/scan',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' },
    body: formData
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "job_id": "scan_xyz789",
  "status": "processing"
}

POST /api/transcript

Audio/Video Transkription

Extrahiert Text aus Audio- und Videodateien mittels Whisper AI.

Parameter

Name	Typ	Beschreibung
`file` required	File	Audio/Video Datei (multipart/form-data)
`language`	string	Sprache (z.B. "de", "en"). Auto-detect wenn leer.

Beispiele

cURL

BASH

curl -X POST "https://loadsh.it/api/transcript" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -F "[email protected]" \
  -F "language=de"

JavaScript

JAVASCRIPT

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('language', 'de');

const response = await fetch(
  'https://loadsh.it/api/transcript',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' },
    body: formData
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "job_id": "trans_def456",
  "status": "processing"
}

GET /api/status/:jobId

Job Status abrufen

Prüft den aktuellen Status eines laufenden oder abgeschlossenen Jobs.

Parameter

Name	Typ	Beschreibung
`jobId` required	string	Die Job-ID aus der ursprünglichen Anfrage

Beispiele

cURL

BASH

curl -X GET "https://loadsh.it/api/status/conv_abc123" \
  -H "Authorization: Bearer lsh_live_xxxx"

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/status/conv_abc123',
  {
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' }
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "status": "completed",
  "progress": 100,
  "result": {
    "download_url": "https://loadsh.it/dl/...",
    "expires_at": "2026-02-04T12:00:00Z"
  }
}

GET /api/user/api-keys

API Keys auflisten

Listet alle API Keys des authentifizierten Benutzers auf.

Beispiele

cURL

BASH

curl -X GET "https://loadsh.it/api/user/api-keys" \
  -H "Authorization: Bearer lsh_live_xxxx"

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/user/api-keys',
  {
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' }
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "keys": [
    {
      "id": "key_123",
      "name": "Production",
      "created_at": "2025-01-01",
      "last_used": "2025-01-03"
    }
  ]
}

POST /api/user/api-keys

API Key erstellen

Erstellt einen neuen API Key. Der vollständige Key wird nur einmal angezeigt!

Parameter

Name	Typ	Beschreibung
`name` required	string	Name/Beschreibung des Keys

Beispiele

cURL

BASH

curl -X POST "https://loadsh.it/api/user/api-keys" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App"}'

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/user/api-keys',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer lsh_live_xxxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ name: 'My App' })
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "key": {
    "id": "key_456",
    "name": "My App",
    "token": "lsh_live_xxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

DELETE /api/user/api-keys/:id

API Key löschen

Löscht einen API Key unwiderruflich.

Parameter

Name	Typ	Beschreibung
`id` required	string	ID des zu löschenden Keys

Beispiele

cURL

BASH

curl -X DELETE "https://loadsh.it/api/user/api-keys/key_123" \
  -H "Authorization: Bearer lsh_live_xxxx"

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/user/api-keys/key_123',
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' }
  }
);
const data = await response.json();

Response

JSON

{
  "success": true,
  "message": "Key deleted"
}

Fehlercodes

Code	Bedeutung
400	Ungültige Anfrage (fehlende Parameter)
401	Nicht authentifiziert (ungültiger API Key)
403	Zugriff verweigert (Limit erreicht)
404	Job oder Ressource nicht gefunden
413	Datei zu gross
429	Zu viele Anfragen
500	Server-Fehler