Cara Membuat Tandatangan API

1. Tandatangan Permintaan API

Parameter Header dalam permintaan antarmuka API digunakan untuk menyampaikan informasi tentang permintaan, seperti informasi autentikasi, format data, jenis klien, dll., untuk membantu server memproses dan merespons permintaan dengan benar.

!!! warning Peringatan: Tanda tangan yang diperlukan untuk mengirim permintaan (tanda tangan adalah nilai nama parameter yang diurutkan berdasarkan urutan leksikografis dan dihubungkan dengan token untuk enkripsi MD5) !!!

Contoh nilai:

<code class="language-bash">Masukkan proyek Anda's&quot;Token&quot;&amp;chat_user_id=64673427382a7760153e9f81&amp;page=1&amp;page_size=50&amp;project_id=1
</code>

!!! warning Peringatan: Dokumen antarmuka API <code>wajib</code> field harus diteruskan! !!!

<code>Masukkan proyek Anda's&quot;Token&quot;</code> Dapatkan di <code>Konfigurasi Proyek</code>-<code>Konfigurasi Pengembangan Perusahaan</code>-<code>API Token</code>!!! warning Peringatan: Fungsi ini hanya didukung dalam versi Max, bukan versi Pro. Silakan periksa harga SaleSmartly untuk detailnya !!!

2. Langkah-langkah Pembuatan Tandatangan API

2.1. Pengurutan Parameter

• Pertama, urutkan semua parameter permintaan berdasarkan urutan leksikografis (yaitu urutan abjad A-Z).

!!! warning Peringatan: Token selalu berada di urutan pertama. Hanya parameter yang diurutkan. !!!

<code class="language-Urutan alfabet disusun sebagai berikut">a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z
</code>

• Sebagai contoh, misalkan parameter permintaan Anda adalah:
  • <code>proyek Anda's&quot;Token&quot;</code>
  • <code>chat_user_id=64673427382a7760153e9f81</code>
  • <code>updated_time={&quot;start&quot;:1680000000,&quot;end&quot;:1714027206}</code>
  • <code>page_size=50</code>
  • <code>project_id=Masukkan ID proyek di sudut kiri bawah di sini</code>
  • <code>page=1</code>
• Setelah diurutkan, hasilnya adalah:
  • <code>proyek Anda's&quot;Token&quot;</code>
  • <code>chat_user_id=64673427382a7760153e9f81</code>
  • <code>page=1</code>
  • <code>page_size=50</code>
  • <code>project_id=Masukkan ID proyek di sudut kiri bawah di sini</code>
  • <code>updated_time={&quot;start&quot;:1680000000,&quot;end&quot;:1714027206}</code>

2.2. Penyambungan Parameter

• Hubungkan parameter yang telah diurutkan dengan simbol &.
• String yang disambungkan:

<code class="language-bash">Masukkan proyek Anda's&quot;Token&quot;&amp;chat_user_id=64673427382a7760153e9f81&amp;page=1&amp;page_size=50&amp;project_id=1&amp;updated_time={&quot;start&quot;:1680000000,&quot;end&quot;:1714027206}
</code>

3. Enkripsi MD5

!!! warning Peringatan: Setiap perubahan pada nama atau nilai parameter memerlukan pengurutan ulang dan enkripsi ulang. !!!

String yang disambungkan dienkripsi dengan MD5 untuk menghasilkan string heksadesimal dengan <code>32 karakter huruf kecil</code> <code>external-sign</code> fields. Misalnya, setelah tanda tangan yang diperlukan di atas dienkripsi dengan MD5, Anda akan mendapatkan: