:HttpEndpoint

Description

Appelez l'opération Simple Message Queue (anciennement MNS) pour envoyer une notification à un endpoint via une requête POST. Les notifications prennent en charge les formats suivants :

• Format XML

  Le corps de la requête contient le contenu du message et les paramètres associés.

• Format SIMPLIFIED

  Le corps de la requête contient uniquement le contenu du message. L'ID du message figure dans les en-têtes de la requête.

Requête

Chaque requête comprend les éléments suivants :

• Ligne de requête

  POST /notifications HTTP/1.1

  Par défaut, la section /notifications est indiquée dans la ligne de requête. Si vous spécifiez un URI pour l'endpoint lors de la création d'un abonnement, remplacez /notifications par cet URI.

• Paramètres URI spécifiques à l'opération

  Aucun.

• En-têtes de requête spécifiques à l'opération

  Parameter	Description	Supported content formats
  Authorization	La signature de la requête.	XML et SIMPLIFIED
  x-mns-signing-cert-url	L'URI encodé en Base64 du certificat de signature.	XML et SIMPLIFIED
  x-mns-request-id	L'ID de la requête.	XML et SIMPLIFIED
  x-mns-message-id	L'ID du message à envoyer.	SIMPLIFIED
  x-mns-message-tag	Le tag du message à envoyer.	SIMPLIFIED

• Corps de la requête

  Si vous définissez le paramètre NotifyContentFormat sur XML, le corps de la requête inclut le contenu du message et les paramètres associés.

  Parameter	Description
  TopicOwner	Le propriétaire du topic.
  TopicName	Le nom du topic.
  Subscriber	Le client abonné.
  SubscriptionName	Le nom de l'abonnement.
  MessageId	L'ID du message.
  Message	Le corps du message.
  MessageMD5	Le hachage MD5 du corps du message.
  MessageTag	Le tag utilisé pour filtrer les messages.
  PublishTime	L'heure de publication du message. La valeur est un horodatage au format UNIX. Il s'agit du nombre de millisecondes écoulées depuis le jeudi 1er janvier 1970 à 00:00:00.

  Si vous définissez le paramètre NotifyContentFormat sur SIMPLIFIED, le corps de la requête contient uniquement le corps du message.

Réponse

Chaque réponse comprend les éléments suivants :

• Code d'état HTTP

  HTTP/1.1 204 No Content

  • Si la notification est traitée, le code d'état HTTP 204 est renvoyé. Si ce code n'est pas renvoyé dans un délai de 5 secondes, la requête expire et le système réessaie d'envoyer le message.

  • Si la vérification de la signature de la requête échoue, le code d'état HTTP 403 est renvoyé.

  • En cas d'autres erreurs, le code d'état HTTP 500 est renvoyé.

• En-têtes de réponse spécifiques à l'opération

  Aucun.

• Corps de la réponse

  Aucun.

Exemples

Exemples de requêtes

• Format 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>

• Format 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"}

Exemples de réponses réussies

HTTP/1.1 204 No Content