Aturan

Pusat Data dan URL Dasar

Saat menggunakan REST API, pastikan pusat data yang dipilih sesuai dengan URL dasar yang benar.

POST/v1/mail/<modul>

Format Permintaan API

https://email.api.engagelab.cc/v1/<modul>/<aksi>

Modul: nama modul fungsi, misal modul mail, modul addresslist.

Aksi: aksi dari setiap modul, misal send, add.

Kode Pengembalian API

API mengembalikan data dalam format JSON. Contoh sebagai berikut:

# permintaan berhasil { "result": {} } # Autentikasi gagal { "code": 30000, "message": "Authentication failed", } # Pengambilan data berhasil { "total": 28, "count": 28, "result": [ { "label_id": 598802, "label_name": "xjm226", "create_time": "2022-11-10T15:47:05+0800", "update_time": "2022-11-10T15:47:05+0800" } ] }
              
              # permintaan berhasil
{
  "result": {}
}
# Autentikasi gagal
{
  "code": 30000,
  "message": "Authentication failed",
}
# Pengambilan data berhasil
{
   "total": 28,
   "count": 28,
   "result": [
        {
            "label_id": 598802,
            "label_name": "xjm226",
            "create_time": "2022-11-10T15:47:05+0800",
            "update_time": "2022-11-10T15:47:05+0800"
        }
    ]
}

            
Tampilkan blok kode ini di jendela mengambang
  • httpStatus: 200
  • result: Informasi data

Kode status HTTP

Status Deskripsi Arti
200 Sukses Permintaan berhasil diproses.
400 Permintaan Tidak Valid Permintaan tidak dapat dipahami server karena sintaks yang salah.
401 Tidak Terautentikasi Permintaan memerlukan autentikasi pengguna.
404 Tidak Ditemukan Server tidak menemukan apapun yang cocok dengan Request-URI
500 Kesalahan Server Internal Server mengalami kondisi tak terduga yang mencegah permintaan dipenuhi.

Deskripsi Format Alamat Email

Format alamat email: local_part@domain_part, terdiri dari local_part, @, dan domain_part. Alamat email yang valid harus memenuhi aturan berikut:

  • local_part@domain_part panjang minimal 6 karakter dan maksimal 128 karakter;
  • local_part maksimal 96 karakter dan tidak boleh mengandung karakter @;
  • domain_part hanya boleh berisi a-zA-Z0-9 -. Tidak boleh diawali atau diakhiri dengan -. Total panjang tidak melebihi 255 karakter, dan setiap segmen tidak lebih dari 63 karakter. Top-level domain hanya boleh terdiri dari 2 hingga 20 huruf alfabet (besar/kecil);

Kamus Zona Waktu

Zona Deskripsi
-12 Garis Tanggal Internasional Barat
-11 Waktu Universal Terkoordinasi-11
-10 Kepulauan Aleutian (Hawaii)
-9 Alaska (Waktu Universal Terkoordinasi-09)
-8 Baja California (Waktu Universal Terkoordinasi-08, Waktu Pasifik [AS & Kanada])
-7 Arizona (Chihuahua, La Paz, Mazatlan, Waktu Pegunungan [AS & Kanada], Yukon)
-6 Amerika Tengah (Waktu Tengah [AS & Kanada], Pulau Paskah, Guadalajara, Mexico City, Monterrey, Saskatchewan)
-5 Bogota, Lima, Quito, Rio Branco (Chetumal, Waktu Timur [AS & Kanada], Haiti, Havana, Indiana [Timur], Turks and Caicos)
-4 Asuncion (Waktu Atlantik [Kanada], Caracas, Cuiaba, Georgetown, La Paz, Manaus, San Juan, Santiago)
-3 Araguaina (Brasilia, Cayenne, Fortaleza, Kota Buenos Aires, Greenland, Montevideo, Punta Arenas, Saint Pierre and Miquelon, Salvador)
-2 Waktu Universal Terkoordinasi-02
-1 Azores (Kepulauan Tanjung Verde)
0 Dublin, Edinburgh, Lisbon, London (Monrovia, Reykjavik, Sao Tome)
1 Casablanca (Amsterdam, Berlin, Bern, Roma, Stockholm, Wina, Beograd, Bratislava, Budapest, Ljubljana, Praha, Brussel, Kopenhagen, Madrid, Paris, Sarajevo, Skopje, Warsawa, Zagreb, Afrika Tengah Barat)
2 Amman (Athena, Bukares, Beirut, Kairo, Chisinau, Damaskus, Gaza, Hebron, Harare, Pretoria, Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius, Yerusalem, Kaliningrad, Khartoum, Tripoli, Windhoek)
3 Baghdad (Istanbul, Kuwait, Riyadh, Minsk, Moskow, St. Petersburg, Nairobi)
4 Abu Dhabi, Muscat (Astrakhan, Ulyanovsk, Baku, Izhevsk, Samara, Port Louis, Saratov, Tbilisi, Volgograd, Yerevan)
5 Ashgabat, Tashkent (Ekaterinburg, Islamabad, Karachi, Qyzylorda)
6 Astana (Dhaka, Omsk)
7 Bangkok, Hanoi, Jakarta (Barnaul, Gorno-Altaysk, Hovd, Krasnoyarsk, Novosibirsk, Tomsk)
8 Beijing, Chongqing, Hong Kong, Urumqi (Irkutsk, Kuala Lumpur, Singapura, Perth, Taipei, Ulaanbaatar)
9 Chita (Osaka, Sapporo, Tokyo, Pyongyang, Seoul, Yakutsk)
10 Brisbane (Canberra, Melbourne, Sydney, Guam, Port Moresby, Hobart, Vladivostok)
11 Pulau Bougainville (Chokurdakh, Magadan, Pulau Norfolk, Sakhalin, Kepulauan Solomon, Kaledonia Baru)
12 Anadyr, Petropavlovsk-Kamchatsky (Auckland, Wellington, Waktu Universal Terkoordinasi+12, Fiji)

Kamus Zona Waktu Kalender

time_zone_id zona waktu
Africa/Abidjan +0000
Africa/Algiers +0100
Africa/Bissau +0000
Africa/Cairo +0200
Africa/Casablanca +0000
Africa/Ceuta +0100
Africa/El_Aaiun +0000
Africa/Johannesburg +0200
Africa/Juba +0200
Africa/Khartoum +0200
Africa/Lagos +0100
Africa/Maputo +0200
Africa/Monrovia +0000
Africa/Nairobi +0300
Africa/Ndjamena +0100
Africa/Sao_Tome +0000
Africa/Tripoli +0200
Africa/Tunis +0100
Africa/Windhoek +0200
America/Adak -1000,-0900
America/Anchorage -0900,-0800
America/Araguaina -0300
America/Asuncion -0400,-0300
America/Bahia -0300
America/Bahia_Banderas -0600
America/Barbados -0400
America/Belem -0300
America/Belize -0600
America/Boa_Vista -0400
America/Bogota -0500
America/Boise -0700,-0600
America/Cambridge_Bay -0700,-0600
America/Campo_Grande -0400
America/Cancun -0500
America/Caracas -0400
America/Cayenne -0300
America/Chicago -0600,-0500
America/Chihuahua -0600
America/Costa_Rica -0600
America/Cuiaba -0400
America/Danmarkshavn +0000
America/Dawson -0700
America/Dawson_Creek -0700
America/Denver -0700,-0600
America/Detroit -0500,-0400
America/Edmonton -0700,-0600
America/Eirunepe -0500
America/El_Salvador -0600
America/Fort_Nelson -0700
America/Fortaleza -0300
America/Glace_Bay -0400,-0300
America/Goose_Bay -0300,-0400
America/Grand_Turk -0400,-0500
America/Guatemala -0600
America/Guayaquil -0500
America/Guyana -0400
America/Halifax -0400
America/Havana -0400,-0500
America/Hermosillo -0700,-0700
America/Inuvik -0700,-0600
America/Iqaluit -0500,-0400
America/Jamaica -0500
America/Juneau -0900,-0800
America/La_Paz -0400
America/Lima -0500
America/Los_Angeles -0800,-0700
America/Maceio -0300
America/Managua -0600
America/Manaus -0400
America/Martinique -0400
America/Matamoros -0600,-0500
America/Mazatlan -0700
America/Menominee -0600
America/Merida -0600
America/Metlakatla -0900,-0800
America/Mexico_City -0600
America/Miquelon -0300,-0200
America/Moncton -0400,-0300
America/Monterrey -0600
America/Montevideo -0300
America/New_York -0500,-0400
America/Nome -0900,-0800
America/Noronha -0200
America/Nuuk -0300,-0200
America/Ojinaga -0600
America/Panama -0500
America/Pangnirtung -0500,-0400
America/Paramaribo -0300
America/Phoenix -0700
America/Port-au-Prince -0500,-0400
America/Porto_Velho -0400
America/Puerto_Rico -0400
America/Punta_Arenas -0300
America/Rankin_Inlet -0600,-0500
America/Recife -0300
America/Regina -0600
America/Resolute -0500,-0600
America/Rio_Branco -0500
America/Santarem -0300
America/Santiago -0300,-0400
America/Santo_Domingo -0400
America/Sao_Paulo -0300
America/Scoresbysund -0100,+0000
America/Sitka -0900,-0800
America/St_Johns -0230,-0330
America/Swift_Current -0600
America/Tegucigalpa -0600
America/Thule -0400,-0300
America/Tijuana -0800,-0700
America/Toronto -0500,-0400
America/Vancouver -0800,-0700
America/Whitehorse -0700
America/Winnipeg -0600,-0500
America/Yakutat -0900,-0800
America/Yellowknife -0700,-0600
America/Argentina/Buenos_Aires -0300
America/Argentina/Catamarca -0300
America/Argentina/Cordoba -0300
America/Argentina/Jujuy -0300
America/Argentina/La_Rioja -0300
America/Argentina/Mendoza -0300
America/Argentina/Rio_Gallegos -0300
America/Argentina/Salta -0300
America/Argentina/San_Juan -0300
America/Argentina/San_Luis -0300
America/Argentina/Tucuman -0300
America/Argentina/Ushuaia -0300
America/Indiana/Indianapolis -0500,-0400
America/Indiana/Knox -0600,-0500
America/Indiana/Marengo -0500,-0400
America/Indiana/Petersburg -0500,-0400
America/Indiana/Tell_City -0600,-0500
America/Indiana/Vevay -0500,-0400
America/Indiana/Vincennes -0500,-0400
America/Indiana/Winamac -0400,-0500
America/Kentucky/Louisville -0500,-0400
America/Kentucky/Monticello -0500,-0400
America/North_Dakota/Beulah -0600,-0500
America/North_Dakota/Center -0600,-0500
America/North_Dakota/New_Salem -0600,-0500
Antarctica/Casey +1100
Antarctica/Davis +0700
Antarctica/Macquarie +1100
Antarctica/Mawson +0500
Antarctica/Palmer -0300
Antarctica/Rothera -0300
Antarctica/Troll +0000,+0200
Asia/Almaty +0600
Asia/Amman +0300
Asia/Anadyr +1200
Asia/Aqtau +0500
Asia/Aqtobe +0500
Asia/Ashgabat +0500
Asia/Atyrau +0500
Asia/Baghdad +0300
Asia/Baku +0400
Asia/Bangkok +0700
Asia/Barnaul +0700
Asia/Beirut +0200,+0300
Asia/Bishkek +0600
Asia/Chita +0900
Asia/Choibalsan +0800
Asia/Colombo +0530
Asia/Damascus +0300
Asia/Dhaka +0600
Asia/Dili +0900
Asia/Dubai +0400
Asia/Dushanbe +0500
Asia/Famagusta +0200,+0300
Asia/Gaza +0300,+0200
Asia/Hebron +0300,+0200
Asia/Ho_Chi_Minh +0700
Asia/Hong_Kong +0800
Asia/Hovd +0700
Asia/Irkutsk +0800
Asia/Jakarta +0700
Asia/Jayapura +0900
Asia/Jerusalem +0200,+0300
Asia/Kabul +0430
Asia/Kamchatka +1200
Asia/Karachi +0500
Asia/Kathmandu +0545
Asia/Khandyga +0900
Asia/Kolkata +0530
Asia/Krasnoyarsk +0700
Asia/Kuching +0800
Asia/Macau +0800
Asia/Magadan +1100
Asia/Makassar +0800
Asia/Manila +0800
Asia/Nicosia +0300,+0200
Asia/Novokuznetsk +0700
Asia/Novosibirsk +0700
Asia/Omsk +0600
Asia/Oral +0500
Asia/Pontianak +0700
Asia/Pyongyang +0900
Asia/Qatar +0300
Asia/Qostanay +0600
Asia/Qyzylorda +0500
Asia/Riyadh +0300
Asia/Sakhalin +1100
Asia/Samarkand +0500
Asia/Seoul +0900
Asia/Shanghai +0800
Asia/Singapore +0800
Asia/Srednekolymsk +1100
Asia/Taipei +0800
Asia/Tashkent +0500
Asia/Tbilisi +0400
Asia/Tehran +0330
Asia/Thimphu +0600
Asia/Tokyo +0900
Asia/Tomsk +0700
Asia/Ulaanbaatar +0800
Asia/Urumqi +0600
Asia/Ust-Nera +1000
Asia/Vladivostok +1000
Asia/Yakutsk +0900
Asia/Yangon +0630
Asia/Yekaterinburg +0500
Asia/Yerevan +0400
Atlantic/Azores -0100,+0000
Atlantic/Bermuda -0400,-0300
Atlantic/Canary +0000,+0100
Atlantic/Cape_Verde -0100,-0100
Atlantic/Faroe +0000,+0100
Atlantic/Madeira +0000,+0100
Atlantic/South_Georgia -0200
Atlantic/Stanley -0300
Europe/Andorra +0100,+0200
Europe/Astrakhan +0400
Europe/Athens +0200,+0300
Europe/Belgrade +0100,+0200
Europe/Berlin +0100,+0200
Europe/Brussels +0100,+0200
Europe/Bucharest +0200,+0300
Europe/Budapest +0100,+0200
Europe/Chisinau +0200,+0300
Europe/Dublin +0000,+0100
Europe/Gibraltar +0100,+0200
Europe/Helsinki +0200,+0300
Europe/Istanbul +0300,+0300
Europe/Kaliningrad +0200
Europe/Kirov +0300
Europe/Kyiv +0300,+0200
Europe/Lisbon +0100,+0000
Europe/London +0000,+0100
Europe/Madrid +0100,+0200
Europe/Malta +0100,+0200
Europe/Minsk +0300
Europe/Moscow +0300
Europe/Paris +0100,+0200
Europe/Prague +0100,+0200
Europe/Riga +0200,+0300
Europe/Rome +0100,+0200
Europe/Samara +0400
Europe/Saratov +0400
Europe/Simferopol +0300
Europe/Sofia +0200,+0300
Europe/Tallinn +0200,+0300
Europe/Tirane +0100,+0200
Europe/Ulyanovsk +0400
Europe/Vienna +0100,+0200
Europe/Vilnius +0200,+0300
Europe/Volgograd +0300
Europe/Warsaw +0100,+0200
Europe/Zurich +0100,+0200
Indian/Chagos +0600
Indian/Maldives +0500
Indian/Mauritius +0400
Pacific/Auckland +1200,+1300
Pacific/Bougainville +1100
Pacific/Chatham +1245,+1345
Pacific/Easter -0500,-0600
Pacific/Efate +1100
Pacific/Fakaofo +1300
Pacific/Fiji +1200
Pacific/Galapagos -0600
Pacific/Gambier -0900
Pacific/Guadalcanal +1100
Pacific/Guam +1000
Pacific/Honolulu -1000
Pacific/Kanton +1300
Pacific/Kiritimati +1400
Pacific/Kosrae +1100
Pacific/Kwajalein +1200
Pacific/Marquesas -0930
Pacific/Nauru +1200
Pacific/Niue -1100
Pacific/Norfolk +1100,+1200
Pacific/Noumea +1100
Pacific/Pago_Pago -1100
Pacific/Palau +0900
Pacific/Pitcairn -0800
Pacific/Port_Moresby +1000
Pacific/Rarotonga -1000
Pacific/Tahiti -1000
Pacific/Tarawa +1200
Pacific/Tongatapu +1300

Kamus Rate

Langkah Deskripsi
-1 Gratis
1 100 per jam, 1k per hari
2 250 per jam, 2.5k per hari
3 250 per jam, 5k per hari
4 650 per jam, 6.5k per hari
5 800 per jam, 8k per hari
6 1k per jam, 10k per hari
7 1,4k per jam, 14k per hari
8 2k per jam, 20k per hari
9 2,5k per jam, 25k per hari
10 3,5k per jam, 35k per hari
11 5k per jam, 50k per hari
12 8k per jam, 80k per hari
13 12k per jam, 120k per hari
14 17,5k per jam, 175k per hari
15 25k per jam, 250k per hari

Kondisi Filter

Struktur Kondisi Filter

{ "condition": { "relation": "or", "items": [ { "field_name": "createTime", "op": ">=", "value": "2021-10-11" }, { "field_name": "Name", "op": "contain", "value": "left" } ] } } # Kondisi filter: createTime >= '2021-10-11' atau Name mengandung 'left'
              
              {
    "condition": {
        "relation": "or",
        "items": [
            {
                "field_name": "createTime",
                "op": ">=",
                "value": "2021-10-11"
            },
            {
                "field_name": "Name",
                "op": "contain",
                "value": "left"
            }
        ]
    }
}

# Kondisi filter: createTime >= '2021-10-11' atau Name mengandung 'left'

            
Tampilkan blok kode ini di jendela mengambang

Penjelasan Kondisi Filter

Parameter Deskripsi
condition Grup kondisi filter
relation Relasi kondisi (and atau or)
items Kondisi filter, lihat tabel di bawah
fieldName fieldType op Deskripsi
Kondisi Filter Filter berdasarkan Tag tag Tidak Ada ( == , != , contain , does not contain ) Buat tag terlebih dahulu sebelum memfilter berdasarkan tag
Filter berdasarkan field Field sistem
(Email, Name, Phone)
Teks ( contain , does not contain ) Mewakili email, nama, nomor telepon masing-masing
Field sistem
(createTime, updateTime, unsubscribeTime)
Tanggal ( == , != , < , > , <= , >= ) Mewakili tanggal pembuatan, tanggal pembaruan, tanggal berhenti berlangganan. Format: DD/MM/YYYY, misal 02/04/2022, tidak boleh 2/4/2022
Nama field kustom umum
(misal SendTime)
Tanggal ( == , != , < , > , <= , >= ) Format: MM/DD/YYYY atau DD/MM/YYYY
Nama field kustom umum
(misal Birthday)
Tanggal Lahir ( == , != , < , > , <= , >= ) Format: MM/DD atau DD/MM
Nama Atribut Kustom Umum
(misal Umur)
Angka ( == , != , < , > , <= , >= ) Format: 0 atau .0 atau .00
Nama Atribut Kustom Umum
(misal Gender)
Dropdown ( == , != ) Saat membuat atribut ini, isi opsi harus diatur bersamaan, maksimal 10 opsi
Nama Atribut Kustom Teks, Tanggal, Tanggal Lahir, Angka, atau Dropdown Ditentukan oleh fieldType Nilai untuk atribut kustom lainnya
icon
Hubungi Sales