useNotification
useNotification bringt Push-Benachrichtigungen in fremde Apps: ein Mensch abonniert deine App, du schickst ihm, was er wissen muss. Freigegeben ist hier die Unternehmensseite — deine Apps, ihre Abonnenten, der Versand an sie. Was die App für ihre Nutzer tut (Konto, Anmeldung, Abonnieren), bleibt in der App und hat hier bewusst keinen Endpunkt. Ein Token gilt für genau einen Anbieter: das Konto, dem die Apps gehören. Wie Menschen zu Abonnenten werden, steht in Abonnenten gewinnen — dafür braucht es keine API, sondern einen Link.
APIs
| API | Host | Inhalt | Requests |
|---|---|---|---|
| App-API | apps.api.usenotification.artim-industries.com/v1 | Die eigenen Apps: anlegen, bearbeiten, Webhook und API-Key. | 11 |
| Abonnenten-API | subscribers.api.usenotification.artim-industries.com/v1 | Wer eine App abonniert hat — Zahlen, Zeitpunkte, Erreichbarkeit. | 5 |
| Nachrichten-API | messages.api.usenotification.artim-industries.com/v1 | Versand an einzelne Abonnenten, Broadcasts und der Verlauf. | 6 |
Gemeinsame Regeln
- Eine Subdomain je API. Ein Token der App-API kommt an der Abonnenten-API nicht vorbei, auch nicht über den Pfad.
- Ein Anbieter je Token. Beim Autorisieren gibt der Nutzer genau einen Anbieter 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.