Dateien

Eine Datei ist ein binärer Inhalt wie ein Profilbild oder ein Firmenlogo. URLs wie pictureFileUrl zeigen hierher und brauchen dasselbe Bearer-Token wie der Rest der API.

Jeder Endpunkt unten zeigt in der Mitte seine Parameter und Antwortfelder und rechts ein Anfragebeispiel mit Beispielantwort.

Basis-URL https://api.sally.ioVersion v1.0 aktuell, noch nicht eingefrorenSo funktioniert die Versionierung

Streamt eine Datei (z. B. ein Profilbild) anhand ihrer Id

GET/v1.0/files/{fileId}

Gibt die rohen Bytes der Datei mit dem gespeicherten Content-Type zurück. Wird von pictureFileUrl referenziert. Erfordert denselben Bearer-Token wie der Rest der API. 404, wenn die Datei nicht existiert.

Pfadparameter

• fileIdstringPflicht

  Id der Datei.

Statuscodes

• 200Rohe Bytes der Datei.
• 400

  Ungültige Anfrage (Validierungsfehler).

• 401

  Fehlender oder ungültiger Bearer-Token.

• 404

  Ressource nicht gefunden oder nicht zugänglich.

• 429

  Rate-Limit überschritten (pro Token/IP). Transkriptions-Uploads können außerdem den code FUP_LIMIT_EXCEEDED oder TOO_MANY_CONCURRENT_TRANSCRIPTIONS zurückgeben.

• 500

  Interner Serverfehler.

Anfrage

cURL

curl "https://api.sally.io/v1.0/files/$FILE_ID" \
  -H "Authorization: Bearer $SALLY_TOKEN" \
  -o file

JavaScript

const response = await fetch(`https://api.sally.io/v1.0/files/${fileId}`, {
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
  },
});
const file = await response.blob();

Python

import os
import requests

response = requests.get(
    f"https://api.sally.io/v1.0/files/{file_id}",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
)
content = response.content

Beispielantwort 200 OK

Liefert die Datei selbst als Binärstrom, kein JSON.