Simple Message Queue (formerly MNS):Protokol permintaan

Parameter

Wajib

Deskripsi

Authorization

Ya

String autentikasi. Untuk informasi selengkapnya, lihat Metode penandatanganan permintaan.

Content-Length

Ya

Panjang badan permintaan HTTP.

Content-Type

Ya

Tipe MIME dari konten permintaan. Saat ini, hanya format teks dan XML yang didukung.

Content-MD5

Tidak

Hash MD5 dari badan permintaan HTTP. Untuk informasi selengkapnya, lihat The Content-MD5 Header Field.

Date

Ya

Waktu saat permintaan dibuat. Waktu harus dalam format GMT. Jika selisih waktu antara permintaan dan waktu server SMQ melebihi 15 menit, permintaan dianggap tidak valid.

Host

Wajib untuk HTTP/1.1. Opsional untuk HTTP/1.0.

Titik akhir permintaan. Formatnya adalah $AccountId.mns.cn-hangzhou.aliyuncs.com. Dapatkan AccountId Anda dari website Alibaba Cloud. Temukan titik akhir SMQ yang sesuai untuk wilayah Anda di dokumentasi API.

x-mns-version

Ya

Versi API SMQ yang digunakan. Versi saat ini adalah 2015-06-06.

x-mns-date

Tidak

Alternatif untuk header Date. Gunakan header ini jika lingkungan client atau browser Anda mencegah Anda menyetel header Date standar.

Parameter

Deskripsi

Content-Length

Panjang badan respons HTTP.

Connection

Status koneksi HTTP.

Date

Waktu respons dihasilkan, dalam format GMT.

Server

Nama server SMQ yang menangani permintaan.

x-mns-request-id

ID unik untuk permintaan tersebut.

x-mns-version

Versi API SMQ. Versi saat ini adalah 2015-06-06.

Parameter

Deskripsi

HttpMethod

Metode permintaan HTTP dalam huruf kapital. Contoh: PUT, GET, POST, DELETE.

Content-Md5

Hash MD5 dari badan permintaan. Ini bersifat opsional. Jika header Content-MD5 tidak disertakan dalam permintaan, gunakan string kosong di sini.

CONTENT-TYPE

Tipe konten dari badan permintaan. Jika header Content-Type tidak disertakan dalam permintaan, gunakan string kosong di sini.

DATE

Tanggal dan waktu permintaan.

• Formatnya adalah: Thu, 07 Mar 2012 18:49:58 GMT. Jika Anda menggunakan x-mns-date untuk menggantikan DATE, DATE tidak boleh kosong dan harus diatur ke nilai x-mns-date.

• Bidang ini tidak boleh kosong. Hanya format GMT yang didukung.

• Jika selisih waktu antara permintaan dan waktu server Simple Message Queue (SMQ, formerly MNS) melebihi 15 menit, layanan menganggap permintaan tidak valid dan mengembalikan kode kesalahan 400. Untuk informasi selengkapnya, lihat Kode kesalahan.

CanonicalizedMNSHeaders

Konkatenasi semua header HTTP yang diawali dengan awalan x-mns-. Header-header ini harus diproses sebagai berikut:

• Kunci header harus diubah menjadi huruf kecil.

• Header harus diurutkan secara alfabetis berdasarkan kunci.

• Konkatenasi header seperti yang ditunjukkan pada pseudokode berikut.

  // Original request headers
  Map<String, String> httpHeaders = request.getHeaders();
  // Sort keys and convert to lowercase
  sortHeadersKeyAndToLowerCase(httpHeaders);
  // Concatenate
  Set<String> keySet = httpHeaders.keySet();
  for (String key : keySet) {
      if (key.startsWith("x-mns-")) {
          CanonicalizedMNSHeaders.append(key).append(":")
              .append(httpHeaders.get(key)).append("\n");
      }
  }

CanonicalizedResource

URI dari resource yang diminta HTTP adalah bagian dari alamat titik akhir HTTP yang ditentukan dalam konfigurasi langganan, tidak termasuk nama domain dan port. Misalnya, jika alamat titik akhir yang dikonfigurasi adalah http://123.123.XX.XX:8080/api/test?code=200, URI-nya adalah /api/test?code=200. Jika alamat titik akhir adalah http://www.aliyun.com/mns/help, URI-nya adalah /mns/help.

Parameter

Deskripsi

Base64

Metode encoding Base64.

HMAC-SHA1

Algoritma penandatanganan. SMQ menggunakan metode HMAC-SHA1 yang didefinisikan dalam RFC 2104.

AccessKey secret

Rahasia AccessKey Anda. Ini sesuai dengan ID AccessKey yang digunakan dalam tanda tangan.

UTF-8-Encoding-Of

Format encoding UTF-8.

StringToSign

String-to-sign yang disusun dalam Langkah 1: Susun string-to-sign.