social.colibri.beta.notification.registerPush
Registers a push endpoint for the requesting user's device. Web Push requires endpoint, p256dh, and auth. FCM requires token. APNs requires token and environment.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | notification.beta.colibri.social |
| Indexed |
Procedure
procedure · POSTInput
application/jsonauth
stringThe Web Push subscription's auth secret. Required when provider is webpush.
endpoint
string · uriThe Web Push subscription endpoint. Required when provider is webpush.
environment
stringThe APNs environment the device token belongs to. Required when provider is apns.
knownValues: sandbox | production
p256dh
stringThe Web Push subscription's p256dh key. Required when provider is webpush.
The platform the device runs.
knownValues: web | ios | android | macos
The push provider to register with.
knownValues: webpush | fcm | apns
token
stringThe FCM registration token or the hex-encoded APNs device token. Required when provider is fcm or apns.
Output
application/jsonErrors
AuthRequired
The request has no valid service auth.
InvalidRequest
The fields required for the given provider are missing or malformed.
PushNotConfigured
This AppView has no keypair for the requested provider.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Registers a push subscription (Web Push or FCM) for the authenticated user.
-
Registers a device for push notifications.
-
so.sprk.notification.registerPush
procedureRegister to receive push notifications, via a specified service, for the requesting account. Requires auth.
-
app.didpic.notification.registerPush
procedureBind a device push token to the authenticated viewer.
-
dev.knotless.registerPush
procedureAsks this appview to send the asking account's notifications to a device.