DokumentationProdukteTag der AusbildungUnternehmensprofilUnternehmensprofil V1
Messebewerbung
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Ob und wie sich das Unternehmen für die Messe beworben hat.
Ohne Bewerbung ist applied falsch und state null. Raum und Fläche stehen erst fest, wenn die Messeleitung die Bewerbung angenommen hat.
GET https://company.api.tda.artim-industries.com/v1/application
| Methode | GET |
| Basis | company.api.tda.artim-industries.com/v1 |
| Scope | tda.company.application:read |
| Antwort | 200 |
| Zugang | Developer Mitgliedschaft |
| Auth | Authorization: Bearer tdaapi_… |
Parameter
Dieser Endpunkt nimmt keine Parameter.
Anfrage
curl "https://company.api.tda.artim-industries.com/v1/application" \
-H "Authorization: Bearer tdaapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
applied | boolean | Ob eine Bewerbung vorliegt. |
state | string | PENDING, ACCEPTED, CHANGE_REQUESTED, NOT_FOUND, DECLINED oder null. |
text | string | Der Text der Bewerbung. |
newspaper | boolean | Ob das Unternehmen in der Messezeitung erscheinen möchte. |
speedDating | boolean | Ob es beim Speed-Dating mitmacht. |
space | integer | Die Standgröße aus der Bewerbung. |
room | string | Der zugeteilte Raum, sonst null. |
{
"applied": true,
"state": "ACCEPTED",
"text": "Wir stellen unsere drei Ausbildungsberufe vor.",
"newspaper": true,
"speedDating": false,
"space": 2,
"room": "A 104"
}
Fehler
| Status | code | Wann |
|---|---|---|
401 | invalid_token | Bearer fehlt, ist unbekannt oder abgelaufen. Verlängern über https://api.artim-industries.com/v1/oauth/token. |
403 | missing_scope | Das Token trägt den Scope dieses Endpunkts nicht. |
404 | not_found | Der Eintrag gehört nicht zum freigegebenen Unternehmen — oder die Anfrage kam auf der falschen Subdomain an. |
422 | invalid_request | Ein Parameter hat den falschen Typ oder liegt außerhalb des erlaubten Bereichs. |
429 | rate_limited | Kontingent erschöpft, siehe Retry-After. |
Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.
Rate Limits
Das Limit gilt pro Team, nicht pro Token.
| Zugang | Produktion | Sandbox |
|---|---|---|
| Hobby | 60 Anfragen/Minute | ohne Limit |
| Developer Mitgliedschaft | 10.000 Anfragen/Minute | ohne Limit |
Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.