Tag der Ausbildung
Der Tag der Ausbildung bringt Schülerinnen und Schüler mit Ausbildungsbetrieben zusammen. Die APIs gehören den Ausstellern: ein Token gilt für genau ein Unternehmen, und freigeben kann es nur ein Konto mit der Rolle Unternehmen, dem dieses Unternehmen gehört. Der Weg ist derselbe wie bei den anderen Produkten: autorisieren bei artim/dev, tauschen bei artim/dev, aufrufen unter der Subdomain der API — oder alles zusammen über den MCP.
APIs
| API | Host | Inhalt | Requests |
|---|---|---|---|
| Unternehmensprofil | company.api.tda.artim-industries.com/v1 | Das eigene Unternehmensprofil, die verfügbaren Tags und der Stand der Messebewerbung. | 4 |
| Ausbildungsberufe | jobs.api.tda.artim-industries.com/v1 | Die Ausbildungsberufe, mit denen sich das Unternehmen auf der Messe vorstellt. | 4 |
| Bewertungen | reviews.api.tda.artim-industries.com/v1 | Was Schülerinnen und Schüler über den Stand geschrieben haben — ohne ihre Namen. | 1 |
Gemeinsame Regeln
- Eine Subdomain je API. Ein Token der Unternehmensprofil kommt an der Ausbildungsberufe nicht vorbei, auch nicht über den Pfad.
- Ein Unternehmen je Token. Beim Autorisieren gibt der Nutzer genau ein Unternehmen frei.
- Scopes so fein wie das Feature. Was besonders schutzbedürftig ist, hängt an einem eigenen Scope — nicht am Scope der ganzen Sektion.
- Lesen und schreiben. Anlegen, bearbeiten und löschen folgen in jeder Sektion demselben Muster; siehe Schreibende Endpunkte.
Erste Schritte
- Produkt-APIs & OAuth lesen — der Weg zum Token.
- In der Konsole eine API freischalten und das Konto verknüpfen.
- Client anlegen, autorisieren, Token holen, losfragen.