Available in Classic and VPC
AiTEMS is a NAVER Cloud Platform service that enables you to easily and quickly implement and provide recommendation services tailored to the user's tastes without requiring expertise in machine learning (ML) and AI. The AiTEMS service provides the features to create and manage datasets and schemas for training in the form of RESTful APIs.
To use AiTEMS APIs, you need to subscribe to the AiTEMS service from the NAVER Cloud Platform console first. See Subscribe to AiTEMS service.
Common AiTEMS settings
The following describes commonly used request and response formats in AiTEMS APIs.
Request
The following describes the common request format.
API URL
The request API URL is as follows:
https://aitems.apigw.ntruss.com/api/v1
Request headers
The following describes the headers.
| Field | Required | Description |
|---|---|---|
x-ncp-apigw-timestamp |
Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
|
x-ncp-iam-access-key |
Required | Access key issued on NAVER Cloud Platform
|
x-ncp-apigw-signature-v2 |
Required | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256)
|
Content-type |
Required | Request data formatapplication/json |
Response
The following describes the common response format.
Response status codes
The following describes the response status codes.
| HTTP status code | Code | Message | Description |
|---|---|---|---|
| 201 | - | Created | Creation completed |
| 400 | - | Bad Request | Invalid request |
| 401 | - | Unauthorized | Authentication unavailable |
| 403 | - | Forbidden | Unauthorized |
| 404 | - | Not Found | Resource can't be found. |
| 500 | - | Internal Server Error | Server error |
For information about the HTTP status codes common to NAVER Cloud Platform, see Ncloud API response status codes.
AiTEMS API
The following describes the APIs provided by the AiTEMS service.
Service
The following describes the service-related APIs.
| API | Description |
|---|---|
| Create service | Create new service. |
| Edit service dataset | Set service dataset. |
| Edit service update cycle | Set interval type service update cycle. |
| Get service list | Get complete service list. |
| Get service | Get service details. |
| Request service learning | Request one-time service training. |
| Request service cycle training | Request cyclical service training. |
| Modify service | Edit service information. |
| Delete service | Delete a service. |
| Get training list | Get complete training list. |
| Get training | Get training details. |
| Get update list | Get service update list. |
| Test training result | Test for checking training results. |
| Upload cycle training data | Upload data to run cycle training. |
Dataset
The following describes the dataset-related APIs.
| API | Description |
|---|---|
| Create data sets | Create dataset for training the service. |
| Get dataset list | Get complete dataset list. |
| Get dataset | Get dataset details. |
| Modify dataset | Edit dataset information. |
| Edit dataset description | Edit dataset description. |
| Delete dataset | Delete dataset. |
Schema
The following describes the schema-related APIs.
| API | Description |
|---|---|
| Create schema | Create new schema. |
| Get schema list | Get complete schema list. |
| Get schema | Get schema details. |
| Edit schema description | Edit schema description. |
| Delete schema | Delete schema. |
| Check schema validity | Validate availability of schema information. |
| Get basic schema information | Get required basic schema information. |
AiTEMS related resources
NAVER Cloud Platform provides a variety of related resources to help users better understand AiTEMS APIs.
- AiTEMS API guides
- Create signature: How to create a signature to add to the request header
- Common Ncloud response status codes: Information on common response status codes of NAVER Cloud Platform used by the AiTEMS service
- API Gateway user guide: How to issue the API key to be added to the request header
- Sub Account User Guides: How to issue the access key to be added to the request header
- AiTEMS API guide: Check the AiTEMS API specification and perform simple tests
- How to use the AiTEMS service
- AiTEMS user guide: How to use AiTEMS in the NAVER Cloud Platform console
- Ncloud user environment guide: Explore VPC and Classic environments and supported services.
- Pricing and features: View pricing details and key capabilities.
- Official blog: Introduction of the AiTEMS service and implementation cases on the NAVER Cloud Platform official blog
- Latest service news: The latest news on AiTEMS
- FAQs: Get answers to common AiTEMS questions.
- Contact Support: Get help if you can't find what you need in the user guide.\