API-Dokumentation

Authentifizierung

Für Uploads nutzt du einen Upload-Key. Für Lesen, Löschen und Kontodaten nutzt du einen Key mit Vollzugriff. Sende den passenden Key bei jedem Request über einen dieser Header:

Authorization: Bearer DEIN_KEY

Upload-Endpunkt: Key mit „Nur Upload“ oder „Vollzugriff“
Lesen/Löschen/Kontodaten: Key mit „Vollzugriff“

Datei hochladen

Sende eine Multipart-Anfrage mit einem Feld namens file. Pro Datei sind maximal 200 MB erlaubt. Zusätzlich gelten dein Speicherlimit und die Upload-Rate-Limits.

curl -X POST https://archvd.xyz/api/v1/upload \
  -H "Authorization: Bearer DEIN_UPLOAD_KEY" \
  -F "[email protected]"

{
  "ok": true,
  "code": "a1B2c3D4.png",
  "url": "https://milo.bewetfor.me/a1B2c3D4.png",
  "size": 48213,
  "mime": "image/png",
  "deleteUrl": "https://archvd.xyz/api/v1/delete/a1B2c3D4.png"
}

Datei löschen

Löscht ausschließlich eine Datei, die zu deinem API-Key gehört. Der freigewordene Speicher wird sofort wieder angerechnet.

curl -X POST https://archvd.xyz/api/v1/delete/a1B2c3D4.png \
  -H "Authorization: Bearer DEIN_API_KEY"

Uploads auflisten

Gibt deine neuesten Uploads zurück. limit darf zwischen 1 und 100 liegen.

curl "https://archvd.xyz/api/v1/images?limit=10" \
  -H "X-Api-Key: DEIN_UPLOAD_KEY"

Konto und Speicher

{
  "ok": true,
  "user": {
    "username": "milo",
    "discordId": "1377013151022977205",
    "active": true
  },
  "quota": {
    "limit_bytes": 524288000,
    "used_bytes": 48213,
    "remaining_bytes": 524239787
  }
}

ShareX

Im Dashboard lädt der Button ShareX-Konfiguration eine fertige .sxcu-Datei für die neue API herunter. Screenshots und Dateien werden danach automatisch hochgeladen und die URL wird in die Zwischenablage kopiert.

{
  "Name": "archvd.xyz API",
  "DestinationType": "ImageUploader, FileUploader",
  "RequestMethod": "POST",
  "RequestURL": "https://archvd.xyz/api/v1/upload",
  "Headers": {
    "Authorization": "Bearer DEIN_UPLOAD_KEY"
  },
  "Body": "MultipartFormData",
  "FileFormName": "file",
  "URL": "{json:url}",
  "DeletionURL": "{json:deleteUrl}"
}

Fehlercodes

{
  "ok": false,
  "code": "invalid_api_key",
  "message": "API-Key ist ungültig.",
  "request_id": "req_..."
}