유저 및 이벤트 정보 전송

이 페이지에서는 이벤트 및 유저 데이터 전송에 대한 Open API 스펙을 명시합니다.

사전 작업

서버에서 이벤트를 전송하기 전, 먼저 프로젝트에 유효한 토큰을 발급받아 주세요.

인증 토큰 발급 방법

1. 개요

이벤트 및 유저 데이터를 전송할 수 있도록 제공하는 Open API입니다. 이벤트, 이벤트 속성, 유저에 대한 자세한 설명은 아래 문서에서 확인하세요.

서버에서 Event 및 User 데이터 연동 방법

2. 인증

API를 사용하려면 서버에서 발급받은 API 키를 Authorization 헤더에 포함해야 합니다.

Authorization: Bearer {your_api_key}

또한, 모든 요청에는 프로젝트 ID가 필요합니다.

이를 쿼리 파라미터에 포함하여 전송합니다.

?project_id=your_project_id

3. Open API 명세서

• timestamp 값으로 이벤트가 발생한 시간을 명시하는 경우, ISO 8601 표준에 맞게 전달해주세요.

  • 예) "2025-01-17T05:39:22Z", "2025-01-17T05:39:22+09:00"

Timestamp를 명시적으로 적는 경우, Timezone값에 유의하세요.

• bulk 요청 시, 한 번의 호출당 profiles와 events 각각 1,000개 이하로 요청해주세요.

Update bulk user profiles

post

Updates user profile information in bulk.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

The ID of the project.

Example: your_project_id

Body

application/json

Responses

202

The request has been accepted for processing.

400

Invalid request parameters.

application/json

401

Unauthorized request.

application/json

post

/v1/api/profile/user

HTTPcURLJavaScriptPython

POST /v1/api/profile/user?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "profiles": [
    {
      "user_id": "test-user-123",
      "properties": {
        "mkt_birth": "1999-05-07",
        "mkt_name": "GilDong Hong"
      }
    }
  ]
}

No content

Collect bulk user events

post

Receives a list of events and processes them asynchronously.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

The ID of the project.

Example: your_project_id

Body

application/json

Responses

202

The request has been accepted for processing.

400

Invalid request parameters.

application/json

401

Unauthorized request.

application/json

post

/v1/api/events

HTTPcURLJavaScriptPython

POST /v1/api/events?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 196

{
  "events": [
    {
      "user_id": "test-user-123",
      "event_name": "mkt_search",
      "properties": {
        "mkt_page_url": "http://localhost:3000/checkout",
        "mkt_search_query": "검색"
      },
      "timestamp": "2025-02-02T05:30:11.052Z"
    }
  ]
}

No content

Request user profile deletion

post

Creates an asynchronous deletion job for the specified user profile.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

The ID of the project.

Example: your_project_id

Body

application/json

user_idstringRequiredExample: test-user-123

Responses

202

The request has been accepted for processing.

400

Invalid request parameters.

application/json

401

Unauthorized request.

application/json

post

/v1/api/profile/user/deletion-job

HTTPcURLJavaScriptPython

POST /v1/api/profile/user/deletion-job?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "user_id": "test-user-123"
}

No content

Request bulk user profile deletion

post

Triggers asynchronous deletion of multiple user profiles.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

Project ID

Example: your_project_id

Body

application/json

user_idsstring[] · min: 1Required

Responses

202

Bulk user profile deletion job accepted.

400

Invalid request.

application/json

401

Unauthorized request.

application/json

post

/v1/api/profile/user/deletion-job/bulk

HTTPcURLJavaScriptPython

POST /v1/api/profile/user/deletion-job/bulk?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "user_ids": [
    "test-user-123",
    "test-user-456"
  ]
}

No content

Update bulk device profiles

post

Updates device profile information and user-device mapping in bulk.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

The ID of the project.

Example: your_project_id

Body

application/json

Responses

202

The request has been accepted for processing.

400

Invalid request parameters.

application/json

401

Unauthorized request.

application/json

post

/v1/api/profile/user/device/bulk

HTTPcURLJavaScriptPython

POST /v1/api/profile/user/device/bulk?project_id=text HTTP/1.1
Host: event.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 277

{
  "profiles": [
    {
      "device": {
        "token": "c7uyGzbIQrG4C3KhZnWiEv:APA91bGPLdSDZjwuIO9AVZSc7CtQwcAPqBmhOanbgNmJfNRF4nQ2DJpN2L5N-_f9duJRAaak7k85psjrIJrELrzTQFahkrIKamzrlMm9evnBqPPW9h_r_QmcbY2D",
        "platform": "WEB",
        "opt_in": true
      },
      "user_id": "test-user-123",
      "timestamp": "2026-02-06T10:00:00Z"
    }
  ]
}

No content