Shopping Intent 생성
- 印刷する
- PDF
Shopping Intent 생성
- 印刷する
- PDF
The content is currently unavailable in Ja - 日本語. You are viewing the default Korean version.
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC 환경에서 이용 가능합니다.
Shopping Intent의 Profile을 생성합니다.
사용자가 Shopping Intent 생성을 요청하면 NCLUE 시스템은 요청 작업을 등록하고 Profile ID를 반환합니다. 생성 과정은 다음과 같습니다.
생성 과정
| 순서 | 생성 상태 | 설명 |
|---|---|---|
| Step 1 | 등록됨 registered | 생성 작업이 시스템에 등록된 상태. 작업 시작 전 상태로 이 때는 삭제하여 작업 취소 가능 |
| Step 2 | 대기 중 pending | 생성 작업이 시스템 대기열에 올라간 상태 |
| Step 3 | 생성 중 in_progress | 작업이 서버에서 실행되는 상태. 서비스 가용 자원 상황에 따라 생성 시간은 상이함 |
| Step 4 | 생성 완료
| 생성이 완료되면, 성공했을 때 '사용 가능' 상태가 되어 정상적으로 사용 가능. 만약 작업에 오류가 발생한 경우, '실패' 상태가 되고, 오류 메시지를 참고하여 문제 해결 가능 |
Shopping Intent 생성은 서비스 가용 자원 상황에 따라 작업 시간에 차이가 있습니다. 생성 진행 단계는 Shopping Intent 조회 API를 호출하여 응답 바디의 'status'필드를 확인해 주십시오.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| POST | /api/v1/profile/shopping-intents |
요청 헤더
NCLUE API에서 공통으로 사용하는 헤더 정보는 NCLUE 공통 헤더를 참조해 주십시오.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
name | String | Required | Profile 이름 (40자 제한) |
task_id | String | Required | Profile 결과를 확인하려는 Task ID |
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://nclue.apigw.ntruss.com/api/v1/profile/shopping-intents' \
--header 'X-NCP-APIGW-TIMESTAMP: {Timestamp}' \
--header 'X-NCP-IAM-ACCESS-KEY: {Access Key}' \
--header 'X-NCP-APIGW-SIGNATURE-V2: {API Gateway Signature}'
--data '{
"name":"펫푸드 사용자 프로파일링",
"task_id":"b5e742f1-0558-465a-8485-3b7808b0e125"
}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
profile_id | String | - | Profile ID |
profile_name | String | - | 사용자가 입력한 Shopping Intent의 Profile 이름 |
task_id | String | - | Profile 결과를 확인하려는 Task ID |
task_name | String | - | Profile 결과를 확인하려는 Task 이름 |
created_at | String | - | Shopping Intent 생성 요청 날짜 (ISO 8601 형식) |
응답 예시
응답 예시는 다음과 같습니다.
성공
호출이 성공한 경우의 응답 예시는 다음과 같습니다.
{
"profile_id":"bce6d560-99ce-4a26-809d-03f750371d52",
"profile_name":"펫푸드 사용자 프로파일링",
"task_id":"b5e742f1-0558-465a-8485-3b7808b0e125",
"task_name":"펫푸드 구매관심 예측모델",
"created_at":"2024-11-04T11:02:34"
}
실패
호출이 실패한 경우의 응답 예시는 응답 상태 코드를 참고해 주십시오.
この記事は役に立ちましたか?