Lizenzen

Jede Mitgliedschaft hat eine Lizenz. Diese Liste löst die licenseId auf, die du an Mitgliedschaften und Einladungen findest.

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.

Listet die Lizenzen auf (löst `licenseId` auf)

GET/v1.0/licensesAusprobieren →

Feldübersicht aus der Spezifikation

Jeder Eintrag enthält:

• licenseId (string): Id der Lizenz.
• name (string): Name der Lizenz (Stufe).

Query-Parameter

• fieldsstringoptional

  Kommagetrennte Liste der Felder, die zurückgegeben werden sollen. Lässt du den Parameter weg, bekommst du alle Felder, auch solche, die in Zukunft hinzukommen. Das ist deine Entscheidung: Nenne deine Felder explizit, wenn du davor geschützt sein willst.

  Nur Felder der ersten Ebene können angegeben werden. Eine verschachtelte Liste wie attendees, tags oder sectionItems wird ganz oder gar nicht zurückgegeben; attendees.name wird nicht unterstützt.

  Bei einer paginierten Antwort gilt die Auswahl für die Einträge in items; page, pageSize, total und hasMore werden immer zurückgegeben. Ein unbekannter Name wird mit 400 abgelehnt statt ignoriert.

  Hier auswählbar: licenseId, name.

  Beispiel: licenseId,name

Antwort

• licenseIdstringPflicht

  Id der Lizenz.

• namestringPflicht

  Name der Lizenz (Stufe).

Statuscodes

• 200Erfolg
• 401

  Fehlender oder ungültiger Bearer-Token.

• 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/licenses" \
  -H "Authorization: Bearer $SALLY_TOKEN"

JavaScript

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

Python

import os
import requests

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

Beispielantwort 200 OK

[
  {
    "licenseId": "f5f084e9-b993-425f-ad36-bfd5dc3f0e65",
    "name": "Business"
  }
]