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 salahsign config not exist: Konfigurasi signature tidak adasign_name already exist: Nama signature sudah adacan not update pending status sign: Signature berstatus menunggu peninjauan tidak dapat diperbaruithere 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
- Signature berstatus menunggu peninjauan tidak dapat diperbarui
- Jika terdapat plan pesan menunggu kirim atau sedang berjalan yang menggunakan signature ini, maka tidak dapat diperbarui
- Setelah diperbarui, status signature akan kembali menjadi "Menunggu Peninjauan" (status=1)
- Nama signature tidak boleh mengandung karakter terlarang:
【、】、[、] - ID signature bertipe angka dalam bentuk string
Lampiran
Status Konfigurasi Signature (status)
| Nilai | Penjelasan |
|---|---|
| 1 | Menunggu Peninjauan |
| 2 | Lolos Peninjauan |
| 3 | Ditolak |










