กฎทั่วไป

รูปแบบการร้องขอ API

https://email.api.engagelab.cc/v1/<module>/<action>

Module: ชื่อของโมดูลฟังก์ชัน ตัวอย่างเช่น: mail (โมดูลอีเมล), address_list (รายการที่อยู่) เป็นต้น

Action: การดำเนินการของแต่ละโมดูล เช่น การส่ง การเพิ่ม

รหัสการตอบกลับ API

ผลลัพธ์ที่ส่งคืนโดย API อยู่ในรูปแบบ JSON ดังตัวอย่างด้านล่าง:

# ร้องขอสำเร็จ { "result": {} } # การตรวจสอบสิทธิ์ล้มเหลว { "code": 30000, "message": "Authentication failed", } # การดึงข้อมูลสำเร็จ { "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" } ] }
              
              # ร้องขอสำเร็จ
{
 
  "result": {}
}
# การตรวจสอบสิทธิ์ล้มเหลว
{
  "code": 30000,
  "message": "Authentication failed",
}

# การดึงข้อมูลสำเร็จ
{
    
   "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

สถานะ คำอธิบาย ความหมาย
200 สำเร็จ การตอบกลับสำเร็จ
400 คำร้องขอไม่ถูกต้อง ข้อผิดพลาดในการร้องขอของผู้ใช้
401 ไม่ได้รับอนุญาต การตรวจสอบสิทธิ์ล้มเหลว
404 ไม่พบ ทรัพยากรที่ร้องขอไม่มีอยู่
500 ข้อผิดพลาดภายในเซิร์ฟเวอร์ ข้อผิดพลาดของเซิร์ฟเวอร์ มักเกิดจากเซิร์ฟเวอร์ไม่สามารถประมวลผลพารามิเตอร์ของผู้ใช้ได้อย่างถูกต้อง (ในกรณีนี้ไม่สามารถระบุได้ว่าการร้องขอสำเร็จหรือไม่)

คำอธิบายรูปแบบอีเมล

รูปแบบที่อยู่อีเมล: local_part@domain_part ซึ่งประกอบด้วย local_part, @ และ domain_part ที่อยู่อีเมลที่ถูกต้องต้องปฏิบัติตามกฎดังต่อไปนี้:

  • local_part@domain_part ต้องมีความยาวอย่างน้อย 6 ตัวอักษรและไม่เกิน 128 ตัวอักษร;
  • ความยาวสูงสุดของสตริง local_part คือ 96 ตัวอักษร และไม่สามารถมีตัวอักษร @;
  • domain_part สามารถมีเฉพาะ a-zA-Z0-9-. และไม่สามารถเริ่มต้นหรือสิ้นสุดด้วย - โดยมีความยาวรวมไม่เกิน 255 ตัวอักษร แต่ละส่วนไม่เกิน 63 ตัวอักษร และโดเมนระดับบนสุดต้องประกอบด้วยตัวอักษรภาษาอังกฤษตัวพิมพ์ใหญ่หรือตัวพิมพ์เล็ก 2~20 ตัวอักษร;

พจนานุกรมเขตเวลา

เขต คำอธิบาย
-12 เส้นวันที่สากลตะวันตก
-11 เวลาสากลเชิงพิกัด-11
-10 หมู่เกาะอะลูเชียน (ฮาวาย)
-9 อลาสกา (เวลาสากลเชิงพิกัด-09)
-8 บาฮาแคลิฟอร์เนีย (เวลาสากลเชิงพิกัด-08, เวลามาตรฐานแปซิฟิก [สหรัฐอเมริกา & แคนาดา])
-7 แอริโซนา (ชิวาวา, ลาปาซ, มาซาตลัน, เวลามาตรฐานภูเขา [สหรัฐอเมริกา & แคนาดา], ยูคอน)
-6 อเมริกากลาง (เวลามาตรฐานกลาง [สหรัฐอเมริกา & แคนาดา], เกาะอีสเตอร์, กัวดาลาฮารา, เม็กซิโกซิตี้, มอนเตร์เรย์, ซัสแคตเชวัน)
-5 โบโกตา, ลิมา, กีโต, ริโอบรังโก (เชตูมัล, เวลามาตรฐานตะวันออก [สหรัฐอเมริกา & แคนาดา], เฮติ, ฮาวานา, อินเดียนา [ตะวันออก], เติร์กและเคคอส)
-4 อาซุนซิออน (เวลามาตรฐานแอตแลนติก [แคนาดา], การากัส, คูยาบา, จอร์จทาวน์, ลาปาซ, มาเนาส์, ซานฮวน, ซานติอาโก)
-3 อารากวาอินา (บราซิเลีย, คาเยนน์, ฟอร์ตาเลซา, เมืองบัวโนสไอเรส, กรีนแลนด์, มอนเตวิเดโอ, ปุนตาอาเรนัส, แซงปีแยร์และมีเกอลง, ซัลวาดอร์)
-2 เวลาสากลเชิงพิกัด-02
-1 อะซอเรส (หมู่เกาะเคปเวิร์ด)
0 ดับลิน, เอดินบะระ, ลิสบอน, ลอนดอน (มอนโรเวีย, เรคยาวิก, เซาตูเม)
1 คาซาบลังกา (อัมสเตอร์ดัม, เบอร์ลิน, เบิร์น, โรม, สตอกโฮล์ม, เวียนนา, เบลเกรด, บราติสลาวา, บูดาเปสต์, ลูบลิยานา, ปราก, บรัสเซลส์, โคเปนเฮเกน, มาดริด, ปารีส, ซาราเยโว, สโกเปีย, วอร์ซอ, ซาเกร็บ, แอฟริกากลางตะวันตก)
2 อัมมาน (เอเธนส์, บูคาเรสต์, เบรุต, ไคโร, คิชิเนา, ดามัสกัส, กาซา, ฮีบรอน, ฮาราเร, พริทอเรีย, เฮลซิงกิ, เคียฟ, ริกา, โซเฟีย, ทาลลินน์, วิลนีอุส, เยรูซาเล็ม, คาลินินกราด, คาร์ทูม, ตริโปลี, วินด์ฮุก)
3 แบกแดด (อิสตันบูล, คูเวต, ริยาด, มินสค์, มอสโก, เซนต์ปีเตอร์สเบิร์ก, ไนโรบี)
4 อาบูดาบี, มัสกัต (แอสตราคาน, อูลยานอฟสค์, บากู, อิเซฟสค์, ซามารา, พอร์ตหลุยส์, ซาราตอฟ, ทบิลิซี, โวลโกกราด, เยเรวาน)
5 อาชกาบัต, ทาชเคนต์ (เยคาเตรินเบิร์ก, อิสลามาบัด, การาจี, คีซิลออร์ดา)
6 อัสตานา (ธากา, ออมสค์)
7 กรุงเทพฯ, ฮานอย, จาการ์ตา (บาร์เนา, กอร์โน-อัลไตส์ก, โฮฟด์, ครัสโนยาสค์, โนโวซิบีร์สค์, ทอมสค์)
8 ปักกิ่ง, ฉงชิ่ง, ฮ่องกง, อุรุมชี (อีร์คุตสค์, กัวลาลัมเปอร์, สิงคโปร์, เพิร์ธ, ไทเป, อูลานบาตอร์)
9 ชิตา (โอซาก้า, ซัปโปโร, โตเกียว, เปียงยาง, โซล, ยาคุตสค์)
10 บริสเบน (แคนเบอร์รา, เมลเบิร์น, ซิดนีย์, กวม, พอร์ตมอร์สบี, โฮบาร์ต, วลาดิวอสตอค)
11 เกาะบูเกนวิลล์ (โชคูร์ดัค, มากาดาน, เกาะนอร์ฟอล์ก, ซาฮาลิน, หมู่เกาะโซโลมอน, นิวแคลิโดเนีย)
12 อานาดีร์, เปโตรพาฟลอฟสค์-คัมชัตสกี (โอ๊คแลนด์, เวลลิงตัน, เวลาสากลเชิงพิกัด+12, ฟิจิ)

พจนานุกรมเขตเวลาปฏิทิน

time_zone_id เขตเวลา
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

อัตราพจนานุกรม

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

เงื่อนไขการกรอง

โครงสร้างเงื่อนไขการกรอง

{ "condition": { "relation": "or", "items": [ { "field_name": "createTime", "op": ">=", "value": "2021-10-11" }, { "field_name": "Name", "op": "contain", "value": "left" } ] } } # เงื่อนไขการกรอง: createTime >= '2021-10-11' หรือ Name มีคำว่า 'Left'
              
              {
    "condition": {
        "relation": "or",
        "items": [
            {
                "field_name": "createTime",
                "op": ">=",
                "value": "2021-10-11"
            },
            {
                "field_name": "Name",
                "op": "contain",
                "value": "left"
            }
        ]
    }
}

# เงื่อนไขการกรอง: createTime >= '2021-10-11' หรือ Name มีคำว่า 'Left'

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

คำอธิบายเงื่อนไขการกรอง

พารามิเตอร์ คำอธิบาย
condition กลุ่มเงื่อนไขการกรอง
relation ความสัมพันธ์ของเงื่อนไข (and หรือ or)
items เงื่อนไขการกรอง ดูตารางด้านล่าง
fieldName fieldType op คำอธิบาย
เงื่อนไขการกรอง กรองตามแท็ก tag None ( == , != , contain , does not contain ) ต้องสร้างแท็กก่อนจึงจะสามารถกรองตามแท็กได้
กรองตามคุณสมบัติ ชื่อคุณสมบัติระบบ
(Email, Name, Phone)
Text ( contain , does not contain ) แสดงถึงอีเมล ชื่อเล่น หมายเลขโทรศัพท์
ชื่อคุณสมบัติระบบ
(createTime, updateTime, unsubscribeTime)
Date ( == , != , <, >, <=, >= ) แสดงถึงวันที่สร้าง วันที่อัปเดต วันที่ยกเลิกการสมัคร รูปแบบคือ DD/MM/YYYY เช่น 02/04/2022 ไม่ใช่ 2/4/2022
ชื่อคุณสมบัติทั่วไปที่กำหนดเอง
(เช่น SendTime)
Date ( == , != , <, >, <=, >= ) รูปแบบคือ MM/DD/YYYY หรือ DD/MM/YYYY
ชื่อคุณสมบัติทั่วไปที่กำหนดเอง
(เช่น Birthday)
Birthday ( == , != , <, >, <=, >= ) รูปแบบคือ MM/DD หรือ DD/MM
ชื่อคุณสมบัติทั่วไปที่กำหนดเอง
(เช่น Age)
Number ( == , != , <, >, <=, >= ) รูปแบบ: 0 หรือ .0 หรือ .00
ชื่อคุณสมบัติทั่วไปที่กำหนดเอง
(เช่น Gender)
Dropdown ( == , != ) ต้องตั้งค่าตัวเลือกเมื่อสร้างคุณสมบัตินี้ สูงสุด 10 ตัวเลือก
ชื่อคุณสมบัติที่กำหนดเอง หนึ่งใน Text, Date, Birthday, Number, Dropdown กำหนดโดย fieldType ค่าของคุณสมบัติที่กำหนดเองอื่น ๆ
icon
ติดต่อฝ่ายขาย