POST: 통합 프로필 생성 및 업데이트

POST /api/v1/identities

고객의 통합 프로필을 생성 및 업데이트 할 수 있는 API 입니다.

쿼리 파라미터

이름	필수값 여부	타입	설명
service_id	필수	String	서비스 ID

헤더

필드명	필수값 여부	타입	값	설명
Content-Type	필수	String	application/json	-
access_token	필수	String	your-api-token-key	API 인증 토큰

요청 본문

필드명	필수값 여부	타입	설명
identity	필수	Object	이벤트 적재를 위한 공통 속성
request_datetime	필수	Datetime	요청 시각, ISODate 8601 Format, UTC 타임존 기준 2024-06-24T06:42:25.394Z

identity

유저 식별 정보입니다. 아래 필드 중 적어도 하나의 값을 넣어주어야 합니다.

필드명	필수값 여부	타입	설명
external_id	선택	String	외부 ID
phone_no	선택	String	전화 번호
email	선택	String	이메일
kakao_user_id	선택	String	카카오 ID
line_user_id	선택	String	라인 ID

전화번호의 경우 다음과 같은 형식으로 입력해주시기 바랍니다. ex) 821012345678, 82212345678

요청 예시

curl -L \
  -X POST \
  -H 'access_token: ${your-import-api-token}' \
  -H 'Content-Type: application/json' \
  'https://openapi.dfinery.ai/api/v1/identities?service_id=${your-service-id}' \
  -d '{
   "identity":{
      "external_id": "dfn-user-123",
      "email": "[e-mail]",
      "phone_no": "821012345678"
   },
   "request_datetime":"2024-06-24T06:01:48.501Z"
  }
 '

응답 예시

정상 응답

Content-Type: application/json
access_token: text
{
  "status": true,
  "code": 20000,
  "message": "OK",
  "data": true
}

실패 응답

자세한 내용은 상세 응답 참고하시면 됩니다.