AiTEMS 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

AiTEMS는 머신러닝(ML) 및 AI에 대한 전문 지식이 없어도 쉽고 빠르게 사용자의 취향에 맞는 추천 서비스를 구현하고 제공할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. AiTEMS 서비스에서는 학습에 사용할 데이터셋과 스키마를 생성하고 관리하는 기능을 RESTful API 형태로 제공합니다.

참고

AiTEMS API를 사용하려면 먼저 네이버 클라우드 플랫폼 콘솔에서 AiTEMS 서비스 이용을 신청해야 합니다. AiTEMS 서비스 이용 신청을 참조해 주십시오.

AiTEMS 공통 설정

AiTEMS API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://aitems.apigw.ntruss.com/api/v1

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간 (밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
    		•
    x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
  • Access Key 발급 및 확인: 인증키 생성 참조
  • 서브 계정의 Access Key 발급 및 확인: 서브 계정 생성 참조
    		•
    x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
  • Secret Key 발급 및 확인: 인증키 생성 참조
  • 서명 생성: 시그니처 생성 참조
    		•
    Content-type Required 요청 데이터의 형식
  • application/json
    		•

    응답

    공통 응답 형식을 설명합니다.

    응답 상태 코드

    응답 상태 코드에 대한 설명은 다음과 같습니다.

    HTTP 상태 코드 코드 메시지 설명
    201 - Created 생성 완료
    400 - Bad Request 잘못된 요청
    401 - Unauthorized 인증 불가
    403 - Forbidden 권한 없음
    404 - Not Found 리소스를 찾을 수 없음
    500 - Internal Server Error 서버 오류
    참고

    네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

    AiTEMS API

    AiTEMS 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

    Service

    Service 관련 API에 대한 설명은 다음과 같습니다.

    API 설명
    서비스 생성 서비스 생성
    서비스 데이터셋 수정 서비스의 데이터셋 수정
    서비스 업데이트 주기 수정 서비스 업데이트 주기 수정
    서비스 목록 조회 서비스 전체 목록 조회
    서비스 조회 서비스 상세 정보 조회
    서비스 학습 요청 단회적 서비스 학습 요청
    서비스 주기 학습 요청 주기적 서비스 학습 요청
    서비스 수정 서비스 정보 수정
    서비스 삭제 서비스 삭제
    학습 목록 조회 학습 전체 목록 조회
    학습 조회 학습 상세 정보 조회
    업데이트 목록 조회 업데이트 목록 조회
    학습 결과 테스트 학습 결과 확인을 위한 테스트
    주기 학습 데이터 업로드 주기 학습을 진행할 데이터 업로드

    Dataset

    Dataset 관련 API에 대한 설명은 다음과 같습니다.

    API 설명
    데이터셋 생성 데이터셋 생성
    데이터셋 목록 조회 데이터셋 전체 목록 조회
    데이터셋 조회 데이터셋 상세 정보 조회
    데이터셋 수정 데이터셋 정보 수정
    데이터셋 설명 수정 데이터셋 설명 수정
    데이터셋 삭제 데이터셋 삭제

    Schema

    Schema 관련 API에 대한 설명은 다음과 같습니다.

    API 설명
    스키마 생성 스키마 생성
    스키마 목록 조회 스키마 전체 목록 조회
    스키마 조회 스키마 상세 정보 조회
    스키마 설명 수정 스키마 설명 수정
    스키마 삭제 스키마 삭제
    스키마 유효성 체크 스키마 정보의 사용 가능 여부 검증
    기본 스키마 정보 조회 필수 구성 기본 스키마 정보 조회

    AiTEMS 연관 리소스

    AiTEMS API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.