Dokumentation der Bild-Upload-API

Authentifizierung

Jede Anfrage muss die zugewiesene Benutzer-ID und den passenden API-Schlüssel in den Headern senden.

• X-API-User-ID: assigned-user-id
• Authorization: Bearer mtu_live_your_key

Verwendung

Senden Sie multipart/form-data. Verwenden Sie file einmal für ein Bild oder wiederholen Sie das Feld für einen Stapel.

Ein Bild hochladen

curl "https://api.mini-tools.uk/v1/upload" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key" \
  -F "duration=7-day" \
  -F "file=@image.png"

Mehrere Bilder hochladen

curl "https://api.mini-tools.uk/v1/upload" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key" \
  -F "duration=7-day" \
  -F "file=@first.png" \
  -F "file=@second.webp"

Sichere Wiederholungen

Senden Sie für wiederholbare Uploads einen eindeutigen Idempotency-Key. Dieselbe Anfrage mit demselben Schlüssel gibt das erste Ergebnis zurück, ohne erneut hochzuladen oder Kontingent doppelt zu verbrauchen. Andere Dateien mit demselben Schlüssel liefern HTTP 409.

Idempotency-Key: upload-request-001

Anfragefelder

Upload-Antwort

Vollständiger Erfolg liefert HTTP 201. Ein teilweise erfolgreicher Stapel liefert HTTP 207 und listet jedes Ergebnis.

{
  "success": true,
  "partial": false,
  "uploaded": [
    {
      "success": true,
      "key": "7-day/example.png",
      "url": "https://pub.mini-tools.uk/7-day/example.png",
      "duration": "7-day",
      "expires_at": "2026-08-05T12:00:00.000Z",
      "size": 24831,
      "mime": "image/png",
      "risk": "normal"
    }
  ],
  "failed": [],
  "usage": {
    "user_id": "assigned-user-id",
    "plan_type": "custom",
    "temporary": {
      "enabled": true,
      "limit": 100,
      "used": 1,
      "remaining": 99,
      "reset_at": "2026-08-05T16:00:00.000Z",
      "timezone": "Asia/Shanghai"
    },
    "permanent": {
      "enabled": false,
      "limit": 0,
      "used": 0,
      "remaining": 0
    },
    "usage_date": "2026-08-05"
  }
}

Rückgabefelder

Verwendetes und verbleibendes Kontingent

Rufen Sie den Endpunkt vor oder nach einem Upload auf. Die Abfrage verbraucht kein Upload-Kontingent.

curl "https://api.mini-tools.uk/v1/usage" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key"

{
  "success": true,
  "usage": {
    "user_id": "assigned-user-id",
    "plan_type": "custom",
    "temporary": {
      "enabled": true,
      "limit": 100,
      "used": 24,
      "remaining": 76,
      "reset_at": "2026-08-05T16:00:00.000Z",
      "timezone": "Asia/Shanghai"
    },
    "permanent": {
      "enabled": false,
      "limit": 0,
      "used": 0,
      "remaining": 0
    },
    "usage_date": "2026-08-05"
  }
}

Upload-Verlauf abrufen

Gibt nur aktive Uploads des aktuellen API-Benutzers zurück. Jede öffentliche URL ist direkt nutzbar. Speicherdauer, Ablauf und Prüfstatus sind nicht enthalten.

curl "https://api.mini-tools.uk/v1/images?limit=20" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key"

{
  "success": true,
  "records": [
    {
      "key": "7-day/example.png",
      "url": "https://pub.mini-tools.uk/7-day/example.png",
      "size": 24831,
      "mime": "image/png",
      "uploaded_at": "2026-08-05T12:00:00.000Z"
    }
  ],
  "next_cursor": null
}

limit ist standardmäßig 20 und maximal 100. Wenn next_cursor nicht null ist, senden Sie ihn als cursor-Parameter für die nächste Seite.

Hochgeladenes Bild löschen

Löscht ein Bild des authentifizierten API-Benutzers. Bilder anderer API-Benutzer können nicht gelöscht werden. Das Löschen stellt kein Tages- oder Gesamtkontingent wieder her.

curl -X DELETE "https://api.mini-tools.uk/v1/images/7-day/example.png" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key"

{
  "success": true,
  "deleted": {
    "key": "7-day/example.png",
    "url": "https://pub.mini-tools.uk/7-day/example.png"
  }
}

Einschränkungen

• Formate: JPG, PNG, GIF und WebP.
• Maximal 5 MB pro Bild.
• Maximal 10 Bilder und insgesamt 25 MB pro Anfrage.
• Dauer: 1-day, 7-day, 30-day oder permanent, abhängig von den Kontorechten.
• Nur erfolgreiche Bilder verbrauchen Kontingent. Tageskontingente werden um Mitternacht in Asia/Shanghai zurückgesetzt; dauerhafte Kontingente sind Gesamtmengen.
• Verwenden Sie für wiederholbare Uploads einen eindeutigen Idempotency-Key, um Duplikate und doppelten Kontingentverbrauch zu vermeiden.
• API-Zugangsdaten werden erst nach Prüfung der E-Mail-Adresse durch den Administrator aktiviert. API-Uploads unterliegen weiterhin der Inhaltsprüfung.
• Für API- und Web-Uploads gelten dieselben Regeln. Rechtswidrige, schädliche, private oder verletzende Bilder können entfernt werden.

HTTP-Statuscodes

• 200 Abfrage oder Löschung erfolgreich.
• 201 Alle Bilder erfolgreich hochgeladen.
• 207 Stapel teilweise erfolgreich.
• 400 / 413 / 415 Anfrage, Anzahl, Größe oder Bildinhalt ist ungültig.
• 401 / 403 Zugangsdaten ungültig, Konto deaktiviert oder Speichertyp nicht erlaubt.
• 404 Das Bild existiert nicht oder gehört nicht zum aktuellen API-Benutzer.
• 409 Der Idempotency-Key wird verarbeitet oder wurde für einen anderen Upload wiederverwendet.
• 429 Tages- oder Gesamtkontingent ausgeschöpft.
• 503 API-Datenbank vorübergehend nicht verfügbar.

Anwendungsfälle

• Anwendungs-Screenshots aus Bereitstellungs- oder Testabläufen hochladen.
• Produkt- oder Dokumentationsbilder in einer Serveranfrage hochladen.
• Kontingent vor einem automatischen Stapel prüfen.

Verwandte Tools

FAQ