DokumentationProdukteTag der AusbildungUnternehmensprofilUnternehmensprofil V1
Profil bearbeiten
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Ändert Name, Beschreibung, Anschrift, Verweise oder Tags.
Alle Felder sind optional; was fehlt, bleibt, wie es ist. socials wird zusammengeführt — ein leerer String löscht einen Verweis. tags dagegen ersetzt die ganze Liste.
PATCH https://company.api.tda.artim-industries.com/v1/
| Methode | PATCH |
| Basis | company.api.tda.artim-industries.com/v1 |
| Scope | tda.company:update |
| Antwort | 200 |
| Zugang | Developer Mitgliedschaft |
| Auth | Authorization: Bearer tdaapi_… |
Parameter
Dieser Endpunkt nimmt keine Parameter.
Anfragekörper
| Feld | Typ | Bedeutung |
|---|---|---|
name | string | Der neue Name. |
description | string | Die neue Beschreibung. |
address | string | Die neue Anschrift. |
socials | object | Verweise mit den Schlüsseln website, instagram, facebook, linkedIn. Wird mit den bestehenden zusammengeführt; ein leerer String löscht einen Verweis. |
tags | array | Die Kennungen der Tags aus GET /tags. Ersetzt die bisherige Liste. |
Felder, die der Vertrag nicht nennt, werden verworfen — ein Client kann keine eigenen Felder unterschieben.
{
"description": "Familienunternehmen mit 120 Beschäftigten, wir bilden seit 1987 aus.",
"socials": { "instagram": "https://instagram.com/muster", "facebook": "" },
"tags": ["t_1", "t_4"]
}
Anfrage
curl -X PATCH "https://company.api.tda.artim-industries.com/v1/" \
-H "Authorization: Bearer tdaapi_…" \
-H "Content-Type: application/json" \
-d '{ "description": "Familienunternehmen mit 120 Beschäftigten, wir bilden seit 1987 aus.", "socials": { "instagram": "https://instagram.com/muster", "facebook": "" }, "tags": ["t_1", "t_4"] }'
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
api | string | Die Kennung der API, hier tda-company. |
id | string | Die Kennung des Unternehmens. |
name | string | Der Name, unter dem das Unternehmen auf der Messe auftritt. |
description | string | Die Beschreibung im Profil. |
address | string | Die Anschrift. |
logoUrl | string | Die Adresse des Logos. |
backgroundUrl | string | Die Adresse des Hintergrundbilds. |
verified | boolean | Ob das Unternehmen von der Messeleitung bestätigt ist. |
socials | object | Die Verweise website, instagram, facebook und linkedIn — ein leerer String heißt: nicht hinterlegt. |
tags | array | Die Tags des Unternehmens als { id, name }. |
{
"api": "tda-company",
"id": "c0a8…",
"name": "Muster GmbH",
"description": "Familienunternehmen mit 120 Beschäftigten, wir bilden seit 1987 aus.",
"address": "Hauptstraße 1, 47608 Geldern",
"logoUrl": "https://…",
"backgroundUrl": "https://…",
"verified": true,
"socials": { "website": "https://muster.de", "instagram": "", "facebook": "", "linkedIn": "" },
"tags": [{ "id": "t_1", "name": "Handwerk" }]
}
Fehler
| Status | code | Wann |
|---|---|---|
400 | invalid_request | Ein Pflichtfeld fehlt, ein Typ passt nicht, oder ein Verweis zeigt auf etwas, das es hier nicht gibt. |
401 | invalid_token | Bearer fehlt, ist unbekannt oder abgelaufen. |
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. |
409 | conflict | Der Zustand verbietet die Änderung — der Fehlerkörper nennt den Grund. |
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.