:HttpEndpoint

Descrição

Use a operação do Simple Message Queue (formerly MNS) para enviar uma notificação a um endpoint mediante uma requisição POST. As notificações aceitam os seguintes formatos:

• Formato XML

  O corpo da requisição contém o conteúdo da mensagem e os parâmetros associados.

• Formato SIMPLIFIED

  O corpo da requisição inclui apenas o conteúdo da mensagem. O ID da mensagem consta nos cabeçalhos da requisição.

Requisição

Cada requisição é composta pelas seguintes partes:

• Linha de requisição

  POST /notifications HTTP/1.1

  Por padrão, a seção /notifications é especificada na linha de requisição. Caso você tenha definido uma URI para o endpoint ao criar uma assinatura, substitua /notifications por essa URI.

• Parâmetros de URI específicos da operação

  Nenhum.

• Cabeçalhos de requisição específicos da operação

  Parâmetro	Descrição	Formatos de conteúdo compatíveis
  Authorization	Assinatura da requisição.	XML e SIMPLIFIED
  x-mns-signing-cert-url	URI do certificado de assinatura codificada em Base64.	XML e SIMPLIFIED
  x-mns-request-id	ID da requisição.	XML e SIMPLIFIED
  x-mns-message-id	ID da mensagem a ser enviada.	SIMPLIFIED
  x-mns-message-tag	Tag da mensagem a ser enviada.	SIMPLIFIED

• Corpo da requisição

  Se você definir o parâmetro NotifyContentFormat como XML, o corpo da requisição incluirá o conteúdo da mensagem e os parâmetros relacionados.

  Parâmetro	Descrição
  TopicOwner	Proprietário do tópico.
  TopicName	Nome do tópico.
  Subscriber	Cliente assinante.
  SubscriptionName	Nome da assinatura.
  MessageId	ID da mensagem.
  Message	Corpo da mensagem.
  MessageMD5	Hash MD5 do corpo da mensagem.
  MessageTag	Tag usada para filtrar mensagens.
  PublishTime	Horário de publicação da mensagem. O valor é um timestamp no formato de tempo UNIX, representando o número de milissegundos decorridos desde 00:00:00 de quinta-feira, 1º de janeiro de 1970.

  Se o parâmetro NotifyContentFormat estiver definido como SIMPLIFIED, o corpo da requisição conterá somente o corpo da mensagem.

Resposta

Cada resposta é composta pelas seguintes partes:

• Código de status HTTP

  HTTP/1.1 204 No Content

  • O processamento bem-sucedido da notificação retorna o código de status HTTP 204. Se esse código não for retornado em até 5 segundos, a requisição expira e o sistema tenta reenviar a mensagem.

  • Falhas na verificação da assinatura da requisição resultam no código de status HTTP 403.

  • Outros erros retornam o código de status HTTP 500.

• Cabeçalhos de resposta específicos da operação

  Nenhum.

• Corpo da resposta

  Nenhum.

Exemplos

Exemplos de requisições

• Formato XML

      POST /notifications HTTP/1.1
      Host: example.com
      Date: Tue, 08 Dec 2015 06:42:00 GMT
      Content-Length: 300
      Content-Type: text/xml;charset=utf-8
      Content-MD5: OGQzNjAwYjIwMWFiMTliZDlhNzc4YjAwZjc5MGQ4****
      Authorization: QSNS+vn3IqJI4lOh4X/dxTv7Qebi/wrEaBJlzFFTc0hJVRUmrHLQo24ojBUETpz48+jrsjxMGPJTILDw752J****
      User-Agent: Aliyun Notification Service Agent
      x-mns-request-id: 56667BB81FD0E7D12000****
      x-mns-version: 2015-06-06
      x-mns-signing-cert-url: aHR0cDovL21uc3Rlc3Qub3NzLWNuLWhhbmd6aG91LmFsaXl1bmNzLmNvbS94NTA5X3B1YmxpY19jZXJ0aWZpY2F0ZS5w****
  
      <? xml version="1.0" encoding="utf-8"? >
      <Notification xlmns="http://mns.aliyuncs.com/doc/v1/">
          <TopicOwner>$TopicOwner</TopicOwner>
          <TopicName>$TopicName</TopicName>
          <Subscriber>$Subscriber</Subscriber>
          <SubscriptionName>$SubscriptionName</SubscriptionName>
          <MessageId>6CC4D900CA59A2CD-1-15180534A8F-20000****</MessageId>
          <Message>{1:"a", 2:"b"}</Message>
          <MessageMD5>F1E92841751D795AB325861034B5****</MessageMD5>
          <MessageTag>important</MessageTag>
          <PublishTime>1449556920975</MessagePublishTime>
      </Notification>

• Formato SIMPLIFIED

      POST /notifications HTTP/1.1
      Host: example.com
      Date: Tue, 15 Dec 2015 09:12:46 GMT
      Content-Length: 487
      Content-Type: text/plain;charset=utf-8
      Content-MD5: NmY4Njk0MzlmNzg3NTFkMTJiN2M5OWE4ZmYzNTU4****
      Authorization: aXZIpRkRmIavmwceCyrPatB7SaEbOJdWpmFWYX3nFwtmaixK/M/3kl1njY0pgM7mrIB7NlBv5NfUZNkcIjlO****
      User-Agent: Aliyun Notification Service Agent
      x-mns-message-id: 6CC4D900CA59A2CD-1-15180534A8F-20000****
      x-mns-message-tag: important
      x-mns-request-id: 566FD963B2B71C44481F****
      x-mns-signing-cert-url: aHR0cDovL21uc3Rlc3Qub3NzLWNuLWhhbmd6aG91LmFsaXl1bmNzLmNvbS94NTA5X3B1YmxpY19jZXJ0aWZpY2F0ZS5w****
      x-mns-version: 2015-06-06
  
      {1:"a", 2:"b"}

Exemplos de respostas de sucesso

HTTP/1.1 204 No Content