API Reference · 사용자

매체사 사용자 목록 조회

매체사가 자기 publisher_user_id 단위로 ad.ded 측에 누적된 사용자 목록을 조회합니다. 활동(세션·이벤트) 이 있었던 사용자만 반환됩니다.

GET/api/v1/users

요청 파라미터

limit (query, int, default 50, max 200) — 한 페이지에 반환할 항목 수.
offset (query, int, default 0) — 건너뛸 항목 수.
q (query, string, optional) — publisher_user_id 부분 검색.
active_from (query, ISO 8601, optional) — 해당 시각 이후 활동한 사용자만.

요청예시

shell

curl -H "Authorization: Bearer {publisher_secret}" \
     "https://added.blomics.net/api/v1/users?limit=50"

응답 필드

items (array) — 사용자 객체 배열.
total (int) — 전체 개수.

Item 필드

publisher_user_id (string) — 매체사 측 사용자 식별자.
first_seen_at (ISO 8601) — 최초 활동 시각.
last_seen_at (ISO 8601) — 마지막 활동 시각.
session_count (int) — 누적 세션 수.
postback_count (int) — 누적 포스트백 발송 수.

응답예시

json

{
  "items": [
    {
      "publisher_user_id": "user_12345",
      "first_seen_at": "2026-03-15T08:00:00.000Z",
      "last_seen_at": "2026-04-30T11:59:59.000Z",
      "session_count": 42,
      "postback_count": 7
    }
  ],
  "total": 1
}

에러처리

400 INVALID_PARAM — 파라미터 형식 오류.
401 UNAUTHORIZED — 인증 실패.
500 INTERNAL_ERROR — 서버 오류.