Rules
อัพเดทล่าสุด :2023-03-14
API request format
https://email.api.engagelab.cc/v1/<module>/<action>
Module: name of function module, e.g. mail module, addresslist module.
Action: action of each module, e.g. send, add.
API return code
API is returned in the format of JSON.Sample is as below:
# request was successful
{
"result": {}
}
# Authentication failed
{
"code": 30000,
"message": "Authentication failed",
}
# Data acquisition success
{
"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"
}
]
}
# request was successful
{
"result": {}
}
# Authentication failed
{
"code": 30000,
"message": "Authentication failed",
}
# Data acquisition success
{
"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"
}
]
}
โค้ดนี้โชว์เป็นหน้าต่างลอย
- httpStatus: 200
- result: Data information
HTTP status code
Status | Description | Meaning |
---|---|---|
200 | Success | The request has succeeded. |
400 | Bad Request | The request could not be understood by the server due to malformed syntax. |
401 | Unauthorized | The request requires user authentication. |
404 | Not Found | The server has not found anything matching the Request-URI |
500 | Internal Server Error | The server encountered an unexpected condition which prevented it from fulfilling the request. |
Email address format description
Email address format: local_part@domain_part , by local_part, @ and domain_part composition.The legal email address must meet the following rules:
- local_part@domain_part minimum length includes 6 characters and the maximum length is 128 characters;
- local_part maximum length of the part string is 96 characters and cannot contain the @ character;
- domain_part can only contain a-zA-Z0-9 -. It cannot start with - or end with -. The total length does not exceed 255 characters, and each segment does not exceed 63. The top-level domain can only contain 2 to 20 uppercase and lowercase English letters;
Time zone dictionary
Zone | Description |
---|---|
-12 | International Date Line West |
-11 | Coordinated Universal Time-11 |
-10 | Aleutian Islands(Hawaii) |
-9 | Alaska(Coordinated Universal Time-09) |
-8 | Baja California(Coordinated Universal Time-08,Pacific Time [US & Canada]) |
-7 | Arizona(Chihuahua, La Paz, Mazatlan,Mountain Time [US & Canada],Yukon) |
-6 | Central America(Central Time [US & Canada],Easter Island,Guadalajara, Mexico City, Monterrey,Saskatchewan) |
-5 | Bogota, Lima, Quito, Rio Branco(Chetumal,Eastern Time [US & Canada],Haiti,Havana,Indiana [East],Turks and Caicos) |
-4 | Asuncion(Atlantic Time [Canada],Caracas,Cuiaba,Georgetown, La Paz, Manaus, San Juan,Santiago) |
-3 | Araguaina(Brasilia,Cayenne, Fortaleza,City of Buenos Aires,Greenland,Montevideo,Punta Arenas,Saint Pierre and Miquelon,Salvador) |
-2 | Coordinated Universal Time-02 |
-1 | Azores(Cabo Verde Is.) |
0 | Dublin, Edinburgh, Lisbon, London(Monrovia, Reykjavik,Sao Tome) |
1 | Casablanca(Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna,Belgrade, Bratislava, Budapest, Ljubljana, Prague,Brussels, Copenhagen, Madrid, Paris,Sarajevo, Skopje, Warsaw, Zagreb,Western Central Africa) |
2 | Amman(Athens, Bucharest,Beirut,Cairo,Chisinau,Damascus ,Gaza, Hebron ,Harare, Pretoria,Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius,Jerusalem,Kaliningrad,Khartoum,Tripoli,Windhoek) |
3 | Baghdad(Istanbul,Kuwait, Riyadh,Minsk,Moscow, 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, Singapore,Perth,Taipei,Ulaanbaatar) |
9 | Chita(Osaka, Sapporo, Tokyo,Pyongyang,Seoul,Yakutsk) |
10 | Brisbane(Canberra, Melbourne, Sydney,Guam, Port Moresby,Hobart,Vladivostok) |
11 | Bougainville Island(Chokurdakh,Magadan,Norfolk Island,Sakhalin,Solomon Is., New Caledonia) |
12 | Anadyr, Petropavlovsk-Kamchatsky(Auckland, Wellington,Coordinated Universal Time+12,Fiji) |
Calendar time zone dictionary
time_zone_id | time zone |
---|---|
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 |
Rate Dictionary
Step | Description |
---|---|
-1 | Free |
1 | 100 hourly, 1k daily |
2 | 250 hourly, 2.5k daily |
3 | 250 hourly, 5k daily |
4 | 650 hourly, 6.5k daily |
5 | 800 hourly, 8k daily |
6 | 1k hourly, 10k daily |
7 | 1.4k hourly, 14k daily |
8 | 2k hourly, 20k daily |
9 | 2.5k hourly, 25k daily |
10 | 3.5k hourly, 35k daily |
11 | 5k hourly, 50k daily |
12 | 8k hourly, 80k daily |
13 | 12k hourly, 120k daily |
14 | 17.5k hourly, 175k daily |
15 | 25k hourly, 250k daily |
Filter Conditions
Filter Condition Structure
{
"condition": {
"relation": "or",
"items": [
{
"field_name": "createTime",
"op": ">=",
"value": "2021-10-11"
},
{
"field_name": "Name",
"op": "contain",
"value": "left"
}
]
}
}
# Filter condition: createTime >= '2021-10-11' or Name contains 'left'
{
"condition": {
"relation": "or",
"items": [
{
"field_name": "createTime",
"op": ">=",
"value": "2021-10-11"
},
{
"field_name": "Name",
"op": "contain",
"value": "left"
}
]
}
}
# Filter condition: createTime >= '2021-10-11' or Name contains 'left'
โค้ดนี้โชว์เป็นหน้าต่างลอย
Filter Condition Explanation
Parameter | Description |
---|---|
condition | Filter condition group |
relation | Condition relation (and or or) |
items | Filter conditions, see table below |
fieldName | fieldType | op | Description | ||
Filter Conditions | Filter by Tag | tag | None | ( == , != , contain , does not contain ) | Create the tag before filtering by tag |
Filter by field | System field (Email, Name, Phone) |
Text | ( contain , does not contain ) | Represents email, name, phone number respectively | |
System field (createTime, updateTime, unsubscribeTime) |
Date | ( == , != , < , > , <= , >= ) | Represents creation date, update date, unsubscribe date. Format: DD/MM/YYYY, e.g., 02/04/2022, cannot be 2/4/2022 | ||
Common custom field name (e.g., SendTime) |
Date | ( == , != , < , > , <= , >= ) | Format: MM/DD/YYYY or DD/MM/YYYY | ||
Common custom field name (e.g., Birthday) |
Birthday | ( == , != , < , > , <= , >= ) | Format: MM/DD or DD/MM | ||
Common Custom Attribute Name (such as Age) |
Number | ( == , != , < , > , <= , >= ) | Format: 0 or .0 or .00 | ||
Common Custom Attribute Name (such as Gender) |
Dropdown | ( == , != ) | When creating this attribute, options content needs to be set simultaneously, with a maximum of 10 options | ||
Custom Attribute Name | Text, Date, Birthday, Number, or Dropdown | Determined by fieldType | Values for other custom attributes |