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, 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

요청 예시

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": "dfn@gmail.com",
      "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
}

실패 응답

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

Last updated