API Reference · 사용자

회원가입 여부 조회

매체사 서버가 자사 사용자를 ad.ded 서비스로 보내기 전에 '이 사용자가 이미 회원인가' 를 확인합니다. 가입 절차가 있는 연동에서 가입 화면과 로그인 화면 중 어디로 보낼지 결정하는 데 씁니다.

GET/api/v1/users/{publisher_user_id}

언제 쓰나요

매체사 앱이 ad.ded 콘텐츠 진입점을 노출할 때, 사용자가 아직 ad.ded 서비스 회원이 아니라면 약관 동의 등 가입 절차를 먼저 태워야 합니다. 이 엔드포인트는 그 분기를 위한 조회입니다.

가입 절차 없이 사용자를 바로 게이트웨이로 보내는 연동(대부분의 매체사) 이라면 이 API 를 호출할 필요가 없습니다. 그 경우에도 사용자 존재 여부 확인용으로 쓸 수 있습니다.

요청 파라미터

publisher_user_id (path, string) — 매체사 측 사용자 식별자. URL 에 넣을 수 없는 문자가 있으면 URL 인코딩합니다.

요청예시

shell

curl -H "Authorization: Bearer sk_pub_prod_4eC39HqLyjWDarjtT1zdp7dc" \
     "https://added.blomics.net/api/v1/users/user_12345"

응답 필드

user_id (string) — ad.ded 내부 사용자 식별자(UUID).
publisher_user_id (string) — 요청한 매체사 측 식별자.
is_member (boolean) — 회원 여부. 가입 절차가 설정된 연동에서는 가입이 확정된 뒤에만 true 가 됩니다.
status (string) — active 또는 blocked. 차단된 사용자도 회원이므로 is_member 는 true 입니다.
joined_at (ISO 8601 | null) — 가입 정보가 ad.ded 에 적재된 시각. 가입 절차가 없는 연동에서는 null.
confirmed_at (ISO 8601 | null) — 가입 결과를 매체사에 통보해 확정된 시각.
last_login_at (ISO 8601 | null) — 마지막 로그인 검증 시각.
created_at (ISO 8601) — 사용자 레코드 생성 시각.

응답예시 — 회원

json

{
  "user_id": "019f7e94-cc62-7eea-b1a8-2b15af5e2faf",
  "publisher_user_id": "user_12345",
  "is_member": true,
  "status": "active",
  "joined_at": "2026-09-01T02:11:07.000Z",
  "confirmed_at": "2026-09-01T02:11:08.000Z",
  "last_login_at": "2026-09-06T04:20:11.000Z",
  "created_at": "2026-09-01T02:11:07.000Z"
}

응답예시 — 비회원

해당 식별자로 등록된 사용자가 없으면 404 입니다.

json

{
  "code": "NOT_FOUND",
  "message": "Publisher user not found",
  "data": { "publisher_user_id": "user_99999" }
}

매체사 규격에 맞춘 응답 형식

매체사 연동 규격이 고유한 응답 코드 체계를 요구하는 경우(예: 회원 S000 / 비회원 E100), ad.ded 가 그 형식으로 응답하도록 설정할 수 있습니다. 이 경우 위의 표준 응답 대신 약정된 본문과 상태코드가 반환됩니다. 필요하시면 규격서를 담당자에게 전달해 주세요.

사용자 식별자를 본문으로 보내야 할 때

매체사 규격상 사용자 식별자를 URL 경로가 아니라 요청 본문으로(때로는 암호화해서) 보내야 한다면 같은 조회를 POST /api/v1/users 로 호출할 수 있습니다. 본문을 어떻게 해석할지는 매체사별 사전 설정을 따르므로, 이 방식이 필요하면 담당자와 먼저 규격을 확정해야 합니다. 설정 없이 호출하면 400 입니다.

요청예시

shell

curl -X POST \
     -H "Authorization: Bearer sk_pub_prod_4eC39HqLyjWDarjtT1zdp7dc" \
     -H "Content-Type: application/json" \
     -d '{"data":"<약정 방식으로 암호화한 문자열>"}' \
     "https://added.blomics.net/api/v1/users"

에러처리

400 INVALID_PARAM — 본문 조회 설정이 없거나 본문을 해석할 수 없음.
401 UNAUTHORIZED — 인증 실패.
404 NOT_FOUND — 해당 식별자의 사용자 없음 (비회원).
429 TOO_MANY_REQUESTS — 매체사당 분당 600 회를 초과.
500 INTERNAL_ERROR — 서버 오류.