Notificaciones push

Las notificaciones push se utilizan para avisar a los usuarios sobre eventos que ocurren en segundo plano, como mensajes o llamadas entrantes.

Después de autenticarse, un cliente móvil puede registrar un token de notificación push del dispositivo en el servidor utilizando el punto final Registrar dispositivo. Este token se usa para enviar notificaciones push al dispositivo del cliente.

Proveedor de notificaciones push

¹ Los proveedores de notificaciones push específicos de VOIP se utilizan para proporcionar notificaciones enriquecidas para llamadas VOIP en iOS.

Valor	Descripción
gcm	Google Cloud Messaging (Android).
apns	Apple Push Notification Service (iOS).
apns_internal	Servicio interno de notificaciones push de Apple (iOS interno).
apns_voip 1	Servicio de notificaciones push VOIP de Apple (iOS).
apns_internal_voip 1	Servicio de notificaciones push VOIP de Apple (iOS interno).

Endpoints

Registrar dispositivo

POST /users/@me/devices

Registra un token de notificaciones push GCM/APNs para el dispositivo del cliente. Devuelve una respuesta vacía 204 en caso de éxito.

Parámetros JSON

¹ Los tokens de notificación push específicos de VOIP solo se utilizan con PushKit en iOS.

Campo	Tipo	Descripción
provider	string	El proveedor de notificaciones push del dispositivo.
token	string	El token de notificación push que se va a registrar.
voip_provider? 1	string	El proveedor de notificaciones push VOIP del dispositivo.
voip_token? 1	string	El token de notificación push VOIP que se va a registrar.
bypass_server_throttling_supported?	boolean	Indica si el cliente soporta evitar la limitación de frecuencia del servidor para notificaciones push (por defecto false).
bundle_id?	string	El ID del paquete de la aplicación (por defecto com.discord).

Eliminar registro de dispositivo

DELETE /users/@me/devices

Elimina el registro de un token de notificaciones push GCM/APNs para el dispositivo del cliente. Devuelve una respuesta vacía 204 en caso de éxito.

Parámetros JSON

Campo	Tipo	Descripción
provider	string	El proveedor de notificaciones push del dispositivo.
token	string	El token de notificación push que se va a eliminar.

Obtener token de sincronización de dispositivo

GET /users/@me/devices/sync-token

Devuelve un token de sincronización de notificaciones push para el usuario actual. Este token puede usarse para sincronizar tokens de notificaciones push entre múltiples cuentas.

Cuerpo de la respuesta

Campo	Tipo	Descripción
token	string	El token de sincronización de notificaciones push.

Ejemplo de respuesta

{ "token": "ODUyODkyMjk3NjYxOTA2OTkz.ZfoufA.rHvCtpfHjr9kdRab1ZTl83PRhhZ" }

Sincronizar dispositivos

PUT /users/@me/devices/sync

Sincroniza el token de notificaciones push GCM/APNs del cliente entre varias cuentas.

Parámetros JSON

¹ Se puede obtener un token de sincronización de dispositivo para cada cuenta utilizando el punto final Obtener token de sincronización de dispositivo.

Campo	Tipo	Descripción
provider	string	El proveedor de notificaciones push del dispositivo.
token	string	El token de notificación push del dispositivo.
push_sync_tokens 1	array [string]	Tokens de sincronización de dispositivos para cada cuenta.

Cuerpo de la respuesta

Campo	Tipo	Descripción
invalid_push_sync_tokens	array [string]	Tokens de sincronización de dispositivo que son inválidos.

Ejemplo de respuesta

{ "invalid_push_sync_tokens": ["ODUyODkyMjk3NjYxOTA2OTkz.ZfoufA.rHvCtpfHjr9kdRab1ZTl83PRhhZ"] }