：HttpEndpoint

Deskripsi

Anda dapat memanggil operasi Simple Message Queue (sebelumnya MNS) untuk mendorong notifikasi ke titik akhir menggunakan permintaan POST. Notifikasi mendukung format berikut:

• Format XML

  Badan permintaan mencakup konten pesan dan parameter terkait.

• Format SEDERHANA

  Badan permintaan hanya mencakup konten pesan. ID pesan disertakan dalam header permintaan.

Permintaan

Setiap permintaan terdiri dari bagian-bagian berikut:

• Baris permintaan

  POST /notifications HTTP/1.1

  Secara default, bagian /notifications ditentukan dalam baris permintaan. Jika Anda menentukan URI untuk titik akhir saat membuat langganan, Anda dapat mengganti /notifications dengan URI tersebut.

• Parameter URI spesifik operasi

  Tidak ada.

• Header permintaan spesifik operasi

  Parameter	Deskripsi	Format konten yang didukung
  Otorisasi	Tanda tangan permintaan.	XML dan SEDERHANA
  x-mns-signing-cert-url	URI terkode Base64 dari sertifikat tanda tangan.	XML dan SEDERHANA
  x-mns-request-id	ID permintaan.	XML dan SEDERHANA
  x-mns-message-id	ID pesan yang akan dikirim.	SEDERHANA
  x-mns-message-tag	Tag pesan yang akan dikirim.	SEDERHANA

• Badan Permintaan

  Jika Anda mengatur parameter NotifyContentFormat ke XML, badan permintaan mencakup konten pesan dan parameter terkait.

  Parameter	Deskripsi
  PemilikTopik	Pemilik topik.
  NamaTopik	Nama topik.
  Pelanggan	Klien pelanggan.
  NamaLangganan	Nama langganan.
  IDPesan	ID pesan.
  Pesan	Badan pesan.
  MessageMD5	Hash MD5 dari badan pesan.
  TagPesan	Tag yang digunakan untuk menyaring pesan.
  WaktuPublikasi	Waktu ketika pesan dipublikasikan. Nilainya adalah timestamp yang mengikuti format waktu UNIX. Ini adalah jumlah milidetik yang telah berlalu sejak pukul 00:00:00 Kamis, 1 Januari 1970.

  Jika Anda mengatur parameter NotifyContentFormat ke SEDERHANA, badan permintaan hanya mencakup konten pesan.

Respons

Setiap respons terdiri dari bagian-bagian berikut:

• Kode Status HTTP

  HTTP/1.1 204 No Content

  • Jika notifikasi diproses, kode status HTTP 204 dikembalikan. Jika kode status HTTP 204 tidak dikembalikan dalam 5 detik, permintaan habis waktu dan pengiriman pesan diulang.
  • Jika tanda tangan dalam permintaan gagal diverifikasi, kode status HTTP 403 dikembalikan.
  • Jika kesalahan lain terjadi, kode status HTTP 500 dikembalikan.
• Header respons spesifik operasi

  Tidak ada.

• Badan Respons

  Tidak ada.

Contoh

Contoh permintaan

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

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

Contoh respons sukses

HTTP/1.1 204 No Content