DokumentationProdukteuseNotificationAbonnenten-APIAbonnenten-API V1
Profil lesen
In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.
Name und Kontaktdaten hinter einem Abonnement.
Der einzige Endpunkt, der einen Menschen zeigt statt einer Zahl. Er ist deshalb Enterprise: eine Integration, die ihn im Umlauf abfragt, ist ein Adressexport.
GET https://subscribers.api.usenotification.artim-industries.com/v1/subscribers/{id}/profile
| Methode | GET |
| Basis | subscribers.api.usenotification.artim-industries.com/v1 |
| Scope | un.subscribers.profile: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 des Abonnements. |
Anfrage
curl "https://subscribers.api.usenotification.artim-industries.com/v1/subscribers/{id}/profile" \
-H "Authorization: Bearer unapi_…"
Antwort
| Feld | Typ | Bedeutung |
|---|---|---|
id | string | Kennung des Abonnements. |
appId | string | Die abonnierte App. |
firstName | string | Vorname. |
lastName | string | Nachname. |
email | string | Hinterlegte E-Mail-Adresse. |
location | string | Ort, wie im Konto gepflegt. |
subscribedAt | string | Wann abonniert wurde. |
{
"id": "66c0aa11…",
"appId": "66bcfadc…",
"firstName": "Paula",
"lastName": "Arjonilla",
"email": "[email protected]",
"location": "Kevelaer",
"subscribedAt": "2026-08-14T10:00:00"
}
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.