Usar as APIs para push para dispositivos móveis do Amazon SNS - Amazon Simple Notification Service

Se fornecermos uma tradução da versão em inglês do guia, a versão em inglês prevalecerá caso haja qualquer conflito entre as versões. A tradução é fornecida com o uso de tradução por máquina.

Usar as APIs para push para dispositivos móveis do Amazon SNS

Para usar as APIs de push para dispositivos móveis do Amazon SNS, você deve primeiro atender aos pré-requisitos para o serviço de notificações por push, como o Apple Push Notification Service (APNS) e o Firebase Cloud Messaging (FCM). Para obter mais informações sobre os pré-requisitos, consulte Pré-requisitos para notificações ao usuário do Amazon SNS.

Para enviar uma mensagem de notificação por push para um dispositivo um aplicativo móvel usando as APIs, você deve primeiro usar a ação CreatePlatformApplication, que retorna um atributo PlatformApplicationArn. O atributo PlatformApplicationArn é, então, usado por CreatePlatformEndpoint, que retorna um atributo EndpointArn. Em seguida, você pode usar o atributo EndpointArn com a ação Publish para enviar uma mensagem de notificação para um dispositivo e aplicativo móvel, ou você pode usar o atributo EndpointArn com a ação Subscribe de inscrição em um tópico. Para obter mais informações, consulte Visão geral do processo de notificação ao usuário.

As APIs de push para dispositivos móveis do Amazon SNS são as seguintes:

CreatePlatformApplication

Cria um objeto de aplicativo de plataforma para um dos serviços de notificações por push com suporte, como o APNS e o FCM, nos quais os dispositivos e aplicativos móveis podem ser registrados. Retorna um atributo PlatformApplicationArn, que é usado pela ação CreatePlatformEndpoint.

CreatePlatformEndpoint

Cria um ponto final para um dispositivo e aplicação móvel num dos serviços de notificação push suportados. CreatePlatformEndpoint utiliza o PlatformApplicationArn atributo devolvido do CreatePlatformApplication ação. O atributo EndpointArn, que é retornado ao usar CreatePlatformEndpoint, é, então, usado com a ação Publish para enviar uma mensagem de notificação para um dispositivo e aplicativo móvel.

CreateTopic

Cria um tópico no qual as mensagens podem ser publicadas.

DeleteEndpoint

Exclui o endpoint para um dispositivo e aplicativo móvel em um dos serviços de notificações por push compatíveis.

DeletePlatformApplication

Exclui um objeto de aplicativo de plataforma.

DeleteTopic

Exclui um tópico e todas as suas inscrições.

GetEndpointAttributes

Recupera os atributos do endpoint para um dispositivo e aplicativo móvel.

GetPlatformApplicationAttributes

Recupera os atributos da plataforma de objeto de aplicativo.

ListEndpointsByPlatformApplication

Lista os endpoints e atributos de endpoint para dispositivos e aplicativos móveis em um serviço de notificações por push compatível.

ListPlatformApplications

Lista os objetos do aplicativo da plataforma para os serviços de notificações por push compatíveis.

Publish

Envia uma mensagem de notificação para todos os endpoints inscritos em um tópico.

SetEndpointAttributes

Define os atributos para um endpoint para um dispositivo e aplicativo móvel.

SetPlatformApplicationAttributes

Define os atributos do objeto de aplicativo de plataforma.

Subscribe

Prepara para assinar um endpoint enviando ao endpoint uma mensagem de confirmação. Para criar de fato uma inscrição, o proprietário do endpoint deve chamar a ação ConfirmSubscription com o token da mensagem de confirmação.

Unsubscribe

Exclui a inscrição.