Logo Site EngageLab Mark Colored TransparentDokumen
Cari

Memperbarui Konfigurasi Signature

Memperbarui konfigurasi signature yang sudah ada, mendukung perubahan nama signature. Setelah diperbarui, status signature akan kembali menjadi "Menunggu Peninjauan".

Alamat Panggilan

PUT https://smsapi.engagelab.com/v1/sign-configs/:signId

Verifikasi Panggilan

Silakan lihat Verifikasi Panggilan untuk mengetahui cara melakukan autentikasi API.

Contoh Request

Request Header

PUT /v1/sign-configs/987654321 HTTP/1.1 Content-Type: application/json Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0
              
              PUT /v1/sign-configs/987654321  HTTP/1.1
Content-Type: application/json
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

            
Tampilkan blok kode ini di jendela mengambang

Request Body

{ "sign_name": "Nama Perusahaan" }
              
              {
  "sign_name": "Nama Perusahaan"
}

            
Tampilkan blok kode ini di jendela mengambang

Parameter Request

Parameter Path

Parameter Tipe Opsi Penjelasan
signId String Wajib ID signature

Parameter Request Body

Parameter Tipe Opsi Penjelasan
sign_name String Wajib Nama signature, panjang 2-60 karakter, tidak boleh mengandung: []

Parameter Response

Response Sukses

HTTP status code adalah 200, response body berisi field-field berikut:

Field Tipe Deskripsi
code Integer Status code, 0 berarti sukses
message String Deskripsi status

Contoh Sukses

{ "code": 0, "message": "success" }
              
              {
  "code": 0,
  "message": "success"
}

            
Tampilkan blok kode ini di jendela mengambang

Response Gagal

HTTP status code adalah 4xx/5xx, response body berisi field-field berikut:

Field Tipe Deskripsi
code Integer Kode error
message String Detail error

Contoh Error

{ "code": 400, "message": "can not update pending status sign" }
              
              {
  "code": 400,
  "message": "can not update pending status sign"
}

            
Tampilkan blok kode ini di jendela mengambang

Kode Error

Kode Error http code Penjelasan
400 400 Error parameter atau error logika bisnis
500 500 Error internal server

Pesan error umum:

  • invalid signId: Format ID signature salah
  • sign config not exist: Konfigurasi signature tidak ada
  • sign_name already exist: Nama signature sudah ada
  • can not update pending status sign: Signature berstatus menunggu peninjauan tidak dapat diperbarui
  • there are pending or running plans using current sign, can not update: Terdapat plan menunggu kirim atau sedang berjalan yang menggunakan signature ini, tidak dapat diperbarui

Catatan Penting

  1. Signature berstatus menunggu peninjauan tidak dapat diperbarui
  2. Jika terdapat plan pesan menunggu kirim atau sedang berjalan yang menggunakan signature ini, maka tidak dapat diperbarui
  3. Setelah diperbarui, status signature akan kembali menjadi "Menunggu Peninjauan" (status=1)
  4. Nama signature tidak boleh mengandung karakter terlarang: []
  5. ID signature bertipe angka dalam bentuk string

Lampiran

Status Konfigurasi Signature (status)

Nilai Penjelasan
1 Menunggu Peninjauan
2 Lolos Peninjauan
3 Ditolak
Icon Solid Transparent White Qiyu
Hubungi Sales