Ações da API de push para dispositivos móveis
Para usar as APIs de push para dispositivos móveis do Amazon SNS, primeiro é necessário atender aos pré-requisitos do 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 ter mais informações, consulte Configurar notificações de push com o Amazon SNS.
As APIs de push para dispositivos móveis do Amazon SNS são as seguintes:
CreatePlatformApplication-
Cria um objeto de aplicação da plataforma para um dos serviços de notificações por push compatíveis, como o APNs e o FCM, nos quais os dispositivos e as aplicações móveis podem se registrar. Retorna um atributo
PlatformApplicationArn, que é usado pela açãoCreatePlatformEndpoint. CreatePlatformEndpoint-
Cria um endpoint para um dispositivo e aplicativo móvel em um dos serviços de notificação por push compatíveis. O
CreatePlatformEndpointusa o atributoPlatformApplicationArnretornado da açãoCreatePlatformApplication. O atributoEndpointArn, que é retornado ao usarCreatePlatformEndpoint, é, então, usado com a açãoPublishpara 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.
