DokumentationProdukteuseNotificationApp-APIApp-API V1
API-Key lesen
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Der Schlüssel, mit dem diese App Benachrichtigungen auslöst.
Wer diesen Schlüssel hat, kann für diese App auslösen — er ist deshalb Enterprise und jeder Abruf steht im Protokoll.
GET https://apps.api.usenotification.artim-industries.com/v1/apps/{id}/key
| Methode | GET |
| Basis | apps.api.usenotification.artim-industries.com/v1 |
| Scope | un.apps.key:read |
| Antwort | 200 |
| Zugang | Enterprise-Mitgliedschaft (in der Sandbox frei) |
| Auth | Authorization: Bearer unapi_… |
Parameter
| Parameter | Ort | Typ | Pflicht | Bedeutung |
|---|---|---|---|---|
id | Pfad | string | ja | Die Kennung der App. |
Anfrage
curl "https://apps.api.usenotification.artim-industries.com/v1/apps/{id}/key" \
-H "Authorization: Bearer unapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
appId | string | Kennung der App. |
apiKey | string | Der Schlüssel im Klartext. |
{ "appId": "66bcfadc…", "apiKey": "unkey_3f9c…" }
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 Anbieter — 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.