Bei der Code-Erzeugung steuern amount und die Nutzerplätze unterschiedliche Dinge. Zusätzlich entscheidet die Form des JSON-Bodys, ob ALKM einen Warenkorb anlegt.
Mehrere Codes oder mehrere Nutzerplätze?
| Wunsch | Eingabe als einzelnes Objekt |
|---|---|
| Zehn getrennte Codes für jeweils eine Person | amount: 10, totalstudents: 1 |
| Ein gemeinsamer Code für bis zu zehn Personen | amount: 1, totalstudents: 10 |
Die Laufzeit gemeinsamer Codes muss zum Einlöseweg passen. Versprechen Sie nicht pauschal, dass jede später hinzukommende Person erneut die volle Laufzeit erhält. Bei Aktivierung über ALKM wird beim ersten Gebrauch ein gemeinsames Ablaufdatum am Code gesetzt; die Edupool-Oberfläche kann andere Regeln verwenden.
Mehrere Produkte in einem Warenkorb bündeln
Voraussetzungen sind die Bash-Variablen aus dem Einstieg und zwei freigegebene Testprodukte. Ersetzen Sie die Produktnummern und passen Sie die Datumswerte an.
curl --silent --show-error --include \
-H "x-api-key: $ALKM_API_KEY" \
-H 'Content-Type: application/json' \
"$ALKM_BASE_URL/licence/manage/keys/create" \
--data-binary @- <<'JSON'
[
{
"content_identifier": "DEMO-PRODUKT-1",
"internal_order_number": "TEST-WARENKORB-001",
"system": 0,
"totalstudents": 1,
"validfrom": "2026-10-01",
"validto": "2027-10-01",
"duration": 365,
"amount": 1
},
{
"content_identifier": "DEMO-PRODUKT-2",
"internal_order_number": "TEST-WARENKORB-001",
"system": 0,
"totalstudents": 1,
"validfrom": "2026-10-01",
"validto": "2027-10-01",
"duration": 365,
"amount": 1
}
]
JSON
Bei vollständigem Erfolg enthält licences zwei Produktcodes und einen zusätzlichen Datensatz mit content_identifier: "cart". Die Datensätze sind über cart_number verbunden. Identifizieren Sie den Warenkorb über content_identifier, nicht über eine feste Position in der Antwort.
Übergeben Sie dessen token als activation_code an die Kontoaktivierung, um die zugehörigen Produkte zu aktivieren. Die Playout-Endpunkte validate und enroll lösen Warenkörbe nicht auf und ersetzen diesen Aufruf nicht.
Grenzen beachten
- Auch ein Array mit nur einer Position fordert einen Warenkorb an. Verwenden Sie für unabhängige Bestellungen einzelne Objekt-Anfragen.
- Verwenden Sie im Einstieg gleiche Einlösefenster für alle Positionen. Der zusätzliche Warenkorb-Code übernimmt
validtovon der ersten Position, die Produktcodes behalten ihre eigenen Werte. - Prüfen Sie alle Produktcodes und den zusätzlichen Warenkorb-Code in der Antwort. Ein erfolgreicher Gesamtstatus allein belegt nicht die Vollständigkeit.
- Die Erstellung und Kontoaktivierung eines Warenkorbs sind nicht als atomarer Gesamtauftrag abgesichert. Nach einem Fehler können einzelne Positionen bereits verarbeitet sein.
- Planen Sie keine blinden Wiederholungen ein. Gleiche Bestellnummern verhindern keine erneute Code-Ausgabe.
Zugang einrichten: Einstieg in die ALKM-API. Einfacher Einzelcode: Ersten Freischaltcode per API erzeugen. Warenkorb für ein Konto aktivieren: Konten und Buchregal per API verwalten.