API Reference · 사용자

회원가입 여부 조회(모니모)

모니모가 사용자 유입 시점에 호출해 가입 여부를 판독합니다. 회원 ID가 암호화된 본문으로 오는 모니모 규격 전용 경로입니다.

POST/api/v1/users/check모니모 전용

표준 경로가 따로 있습니다

플랫폼 표준 조회는 GET /api/v1/users/{publisher_user_id}이며 다른 매체는 그것을 씁니다. 모니모 규격이 경로 변수를 쓰지 못하고 회원 ID를 암호화된 본문으로만 보내기 때문에 전용 경로를 따로 두었습니다. 판정 로직과 응답 형식은 표준 경로와 동일합니다.

요청

본문의 data에 암호문을 담아 보냅니다. 복호화하면 아래 구조입니다.

mnmAlncSvCriId (string, required) — 제휴서비스 기준ID. 매체 설정값과 다르면 E800으로 거절합니다.
alncSvMbId (string, required) — 조회할 회원 식별키.
timestamp (string, optional) — YYYYMMDDHHMMSS. 판정에는 쓰지 않습니다.

data 없이 alncSvMbId를 평문으로 보내도 동일하게 처리합니다. 암호화 키 수령 전 연동 경로를 확인하기 위한 허용이며, 정식 규격은 암호문입니다.

요청예시

shell

curl -X POST \
  -H "Authorization: Bearer sk_pub_prod_4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{"data":"<AES 암호문>"}' \
  "https://added.blomics.net/api/v1/users/check"

응답

응답 본문은 매체 설정의 응답 템플릿을 따르며 HTTP는 항상 200입니다. 판정 결과는 본문 코드로만 전달합니다.

S000 — 가입이 확정된 회원입니다.
E100 — 비회원. 모니모가 가입 흐름으로 보냅니다.
E800 — 제휴사 에러. 복호화 실패, 필수 필드 누락, 제휴 서비스 ID 불일치가 모두 여기에 해당합니다.

응답예시

json

{
  "responseCode": "S000",
  "responseMsg": "정상 가입 회원"
}

로그인 성공과 회원 판정은 다릅니다

가입 확정(모니모에 가입결과를 통보해 확정된 시점) 전까지는 로그인이 성공하더라도 E100을 돌려줍니다. 모니모가 가입 흐름을 다시 태워 매핑을 완성하도록 하기 위한 설계입니다.

인증과 접근 제한

외부 API 공통 규약(Authorization: Bearer <publisher_secret>또는 HTTP Basic)을 요구합니다. 매체 설정에 IP 허용목록이 있으면 함께 적용되며, 허용되지 않은 IP는 E800으로 응답합니다. 호출 상한은 매체당 분당 600회입니다.