Mendapatkan EUID | Marketing Automation REST API Bahasa Indonesia

EUID adalah pengenal unik dari platform EngageLab MA. Anda dapat menggunakan API berikut untuk mengambil EUID berdasarkan pengenal pengguna.

Jika Anda hanya perlu menanyakan pengguna yang sudah ada, gunakan Menanyakan EUID. API ini tidak membuat pengguna jika pengenal tidak ditemukan.

Alamat Endpoint

POST /v1/user/register

Verifikasi Permintaan

REST API EngageLab menggunakan HTTP Basic Authentication sebagai metode verifikasi. Tambahkan Authorization ke Header HTTP:

Authorization: Basic ${base64_auth_string}

              
              Authorization: Basic ${base64_auth_string}

Tampilkan blok kode ini di jendela mengambang

base64_auth_string dihasilkan menggunakan algoritma berikut: base64(api_key:api_secret).

Nama header adalah "Authorization", dan nilainya adalah pasangan "username:password" yang telah dienkode base64 (dipisahkan titik dua).
Untuk MA API, username adalah APIKey dan password adalah APISecret. Silakan konfigurasikan sumber data tipe API untuk mendapatkan APIKey dan APISecret.

Contoh Permintaan

Header Permintaan

> POST /v1/user/register > Content-Type: application/json > Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

              
              > POST /v1/user/register
> Content-Type: application/json
> Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

Tampilkan blok kode ini di jendela mengambang

Body Permintaan

{ "identity_name":"user_id", "identity_values": [ "18012345678", "18012345678" ] }

              
              {
    "identity_name":"user_id",
    "identity_values": [
        "18012345678",
        "18012345678"
    ]
}

Tampilkan blok kode ini di jendela mengambang

Parameter Permintaan

Field	Tipe	Wajib	Deskripsi
identity_name	String	Ya	Nama pengenal pengguna, mendukung nilai seperti user_id, anonymous_id, atau registration_id
identity_values	list	Ya	Nilai pengenal pengguna, mendukung hingga 100 nilai, setiap nilai maksimal 256 karakter

Parameter Balasan

Field	Tipe	Wajib	Deskripsi
code	Int	Ya	Status pemanggilan API. 0 berarti sukses/berhasil sebagian, nilai lain gagal
message	String	Ya	Deskripsi hasil pemanggilan API, menjelaskan kode balikan
data	Array	Tidak	Daftar EUID yang sesuai dengan pengenal pengguna yang dikembalikan
identity_value	String	Ya	Nilai dari pengenal pengguna
euid	Long	Ya	ID unik pengguna yang sesuai dengan EngageLab MA
error_code	Int	Ya	Status pengambilan EUID. 0 berarti sukses, nilai lain gagal

Semua Berhasil

{ "code": 0, "message": "success", "data": [ { "identity_value": "18012345678", "euid": 10362473, "error_code": 0 }, { "identity_value": "18012340000", "euid": 10362474, "error_code": 0 } ] }

              
              {
    "code": 0,
    "message": "success",
    "data": [
        {
            "identity_value": "18012345678",
            "euid": 10362473,
            "error_code": 0
        },
        {
            "identity_value": "18012340000",
            "euid": 10362474,
            "error_code": 0
        }
    ]
}

Tampilkan blok kode ini di jendela mengambang

Semua Gagal

{ "code": 55101, "message": "Melebihi batas jumlah pengenal pengguna" }

              
              {
    "code": 55101,
    "message": "Melebihi batas jumlah pengenal pengguna"
}

Tampilkan blok kode ini di jendela mengambang

Sebagian Berhasil

{ "code": 0, "message": "success", "data": [ { "identity_value": "18012345678", "euid": null, "error_code": -1 }, { "identity_value": "1801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400008012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000", "euid": null, "error_code": 55105 } ] }

              
              {
    "code": 0,
    "message": "success",
    "data": [
        {
            "identity_value": "18012345678",
            "euid": null,
            "error_code": -1
        },
        {
            "identity_value": "1801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400008012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000",
            "euid": null,
            "error_code": 55105
        }
    ]
}

Tampilkan blok kode ini di jendela mengambang

Kode Error

Kode	Deskripsi	Penjelasan Detail
40050	Autentikasi antarmuka gagal.	Pastikan project ID dan secret key proyek sudah benar.
40007	EUID kosong.	Silakan periksa nilai EUID.
50031	Project ID tidak valid.	Silakan periksa apakah APIKey dan APISecret sudah benar.
50034	Project ID tidak ada.	Silakan periksa apakah APIKey dan APISecret sudah benar, dan apakah proyek telah dihapus.
50074	Sumber data API tidak ada.	Silakan periksa apakah APIKey dan APISecret sudah benar, dan apakah sumber data API telah dihapus.
55004	Parameter bisnis tidak valid.	Silakan periksa apakah field parameter permintaan sudah benar.
55101	Jumlah pengenal pengguna melebihi batas.	Pastikan jumlah nilai pengenal pengguna tidak melebihi 100.
55102	Ada nama atribut pengguna yang tidak valid.	Pastikan nama atribut memenuhi syarat penamaan, tidak kosong/tidak menggunakan karakter khusus/tidak melebihi batas panjang.
55103	Nilai atribut pengguna tidak boleh kosong.	Pastikan nilai atribut pengguna dalam body permintaan tidak kosong.
55105	Nilai pengenal pengguna tidak boleh melebihi 256 karakter.	Pastikan nilai pengenal pengguna tidak melebihi 256 karakter.
55106	Nama pengenal pengguna tidak didukung.	Pastikan nama pengenal pengguna adalah user_id, anonymous_id, atau registration_id.
55107	Nilai pengenal pengguna kosong.	Pastikan nilai pengenal pengguna dalam body permintaan tidak kosong.
55108	EUID tidak valid.	Silakan periksa nilai EUID.
-1	Kesalahan internal server.	Silakan hubungi dukungan teknis EngageLab.