สอบถาม EUID | Marketing Automation REST API ภาษาไทย

ใช้ API นี้เพื่อสอบถาม EUID ของผู้ใช้ที่มีอยู่แล้วตามตัวระบุผู้ใช้ที่กำหนดค่าไว้ในโปรเจกต์ API นี้อ่านข้อมูลที่มีอยู่เท่านั้น หากไม่พบข้อมูลที่ตรงกัน จะไม่สร้างผู้ใช้หรือ EUID ใหม่ API นี้จำกัดอัตราการเรียก 1,000 คำขอต่อนาทีต่อโปรเจกต์ หากเกินขีดจำกัดจะตอบกลับ HTTP 429 พร้อมรหัสข้อผิดพลาด 55110

ที่อยู่สำหรับเรียกใช้งาน

POST /v1/user/euid

การตรวจสอบการเรียกใช้งาน

EngageLab REST API ใช้ HTTP Basic Authentication:

Authorization: Basic ${base64_auth_string}

              
              Authorization: Basic ${base64_auth_string}

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

สร้าง base64_auth_string ด้วย base64(api_key:api_secret)

ตัวอย่างคำขอ

{ "identity_name": "user_id", "identity_values": ["user-1", "user-2"] }

              
              {
    "identity_name": "user_id",
    "identity_values": ["user-1", "user-2"]
}

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

พารามิเตอร์คำขอ

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
identity_name	String	ใช่	ชื่อตัวระบุผู้ใช้ที่กำหนดค่าไว้ในโปรเจกต์
identity_values	Array	ใช่	ค่าตัวระบุ 1 ถึง 100 ค่า แต่ละค่าไม่เกิน 256 อักขระ

พารามิเตอร์การตอบกลับ

ฟิลด์	ชนิด	คำอธิบาย
code	Int	0 หมายถึงสำเร็จ รวมถึงกรณีที่ไม่พบค่า
message	String	คำอธิบายผลลัพธ์
data	Array	ผลลัพธ์ตามลำดับเดียวกับคำขอ
identity_value	String	ค่าตัวระบุที่ขอ
euid	Long	EUID ที่มีอยู่ หรือ `null` หากไม่พบผู้ใช้
error_code	Int	0 สำหรับการสอบถามที่สำเร็จ ค่าที่ไม่พบก็คืนค่า 0

ตัวอย่างการตอบกลับ

{ "code": 0, "message": "success", "data": [ {"identity_value": "user-1", "euid": 10362473, "error_code": 0}, {"identity_value": "user-not-found", "euid": null, "error_code": 0} ] }

              
              {
    "code": 0,
    "message": "success",
    "data": [
        {"identity_value": "user-1", "euid": 10362473, "error_code": 0},
        {"identity_value": "user-not-found", "euid": null, "error_code": 0}
    ]
}

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

รหัสข้อผิดพลาด

รหัส	คำอธิบาย
40050	การยืนยันตัวตนของอินเทอร์เฟซล้มเหลว
55004	พารามิเตอร์ธุรกิจไม่ถูกต้อง
55101	จำนวนตัวระบุเกิน 100 ค่า
55105	ค่าตัวระบุยาวเกิน 256 อักขระ
55106	ไม่ได้กำหนดค่าตัวระบุในโปรเจกต์
55107	ชื่อหรือค่าตัวระบุว่างเปล่า
55110	เกินขีดจำกัดอัตราการเรียก (สูงสุด 1,000 คำขอต่อนาทีต่อโปรเจกต์)