Rules

Last updated: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"
            }
        ]
    
}

        
This code block in the floating window
  • 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 10 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'

        
This code block in the floating window

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
在文档中心打开