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. Rechts findest du Anfragebeispiele in cURL, JavaScript und Python, eine Beispielantwort und Ausprobieren, das die Anfrage mit deinem eigenen Token wirklich abschickt.

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

GET/v1.0/files/{fileId}Ausprobieren →

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.

Ausprobieren

Schick diese Anfrage wirklich ab, mit deinem eigenen Token und deinen eigenen Daten.

Anfrage

cURL

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

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.