Application使用指南

可在Classic/VPC环境下使用。

使用之前

Q. Application Service是什么？

• 使用CLOVA、Papago、Maps等提供基于NAVER丰富的数据学习的最新人工智能服务的AI Service和将在NAVER使用的技术以API提供的Application Service可以轻松开发各种服务。

Q. Application Service如何使用？

• 在NAVER Cloud Platform控制台注册应用程序，即可获取对应用程序的认证密钥。可以使用通过认证密钥注册到应用程序的服务API，API请求URL由naveropenapi.apigw.ntruss.com的子URL构成。各服务的详细URL请参考“API使用指南”。

注册应用程序

要使用AI·Naver Service进行开发，需要先注册应用程序。如果应用程序成功注册，每个应用程序都会生成一个唯一的Client ID和Client Secret值。该值在调用API时要包含在HTTP报头值内传送才可以调用。

应用程序注册方法

在控制台菜单选择AI·NAVER API > AI·NAVER API > Application菜单，同意条款后进行应用程序注册。

① 在同意条款后出现的画面输入应用程序名称。

• 名称最多可输入40个字符，但之后也会根据添加的服务性质用于在画面输出的应用程序名，因此最好尽可能使用10个字符以内的简洁的名称。

② 选择要使用的服务。

• 目前可以通过NAVER Cloud Platform关联的服务是一种开放服务，只要向HTTP报头传送Client ID和Secret值即可调用使用。

③ 输入服务环境信息。

• 输入应用程序要提供服务的环境信息。可以选择多个服务URL，但Android应用程序包或iOS Bundle ID只能各注册一个。

  发放给一个应用程序的Client ID和Secret值可以应用于Android、IOS、Web、WindowsApp等多种环境。但请注意API的使用量会按各个客户端ID进行合计。

各服务环境的具体输入事项

• 服务URL: //输入由'http://'开头的web服务URL。服务URL和使用的web信息不同时认证可能会失败。
• 不区分http和https。
• 输入时请去掉www（例：http://naver.com).
• 如果有子域，请仅输入代表域名（例：http://naver.com).
• 混合应用程序只要输入location.href对象输出值即可（例：file://本地URL）。
• Android应用程序包名称：只适用于Android应用程序，请准确输入应用程序包名。注册的程序包名和使用的应用程序包名不同时，认证可能会失败。
• iOS Bundle ID:只适用于iOS应用程序，注册的Bundle ID和使用的应用程序信息不同时，认证可能会失败。

应用程序列表

应用程序正常注册时会如下图显示在AI·NAVER API > AI·NAVER API > Application注册的应用程序名称列表，每个应用程序都可以确认如下信息。

① 服务分类：确认所选的服务。

② 当天/当月使用量：每个应用程序都可以确认用%显示的各项服务的实时使用量。（UTC+9为准)

③ 上限及通知设置：可以直接调节调用API时使用上限和超出特定值(%)时的通知功能。

为使用应用程序的认证信息

① 点击应用程序名称下面的 [认证信息]。

② 可以确认认证密钥和注册的服务环境信息。

• Application Key

  • Application名称：用于区分Application的名称。
  • Client ID (X-NCP-APIGW-API-KEY-ID):与用于认证的ID类似的值，在报头或查询字符串内输入'X-NCP-APIGW-API-KEY-ID'。
  • Client Secret (X-NCP-APIGW-API-KEY):与用于认证的SecretKey密码类似的性质，在报头或查询字符串内输入'X-NCP-APIGW-API-KEY'。
    • 请避免显示在客户端上，为确保安全可重新发放。

• 服务环境

  • Web URL:使用Web SDK时，必须要输入的值
  • Android包名称：使用Android SDK时，必须要输入的值
  • iOS Bundle ID:使用iOS SDK时，必须要输入的值

在调用API时要将Client ID和Client Secret含在HTTP报头值内传送才可以调用。

确认使用量信息及API状态

AI·NAVER API的使用量可以通过3种方法确认。

当日使用量及当月使用量

每个服务都设置有限的每日/每月使用上限。

可以在AI·NAVER API > AI·NAVER API > Application查看。

可以查看实时使用现状。所有API采用UTC+9标准。（韩国时间在00:00 AM，清零每日使用量)

通过百分比和各百分比的颜色标识，可以一眼确认达到上限的情况。

使用上限设置

① 在应用程序列表画面点击要变更的应用程序特定服务的 [上限设置]。

② 输入每月以及每日上限。

临界值通知设置

此功能是使用上限超出特定值(%)时，每10%都会通过邮件或SMS收到通知的功能。

① 在上限设置标签内选中每日上限设置或每月上限设置右侧的复选框。

② 选择成为通知标准的临界值(%)。

• （示例：选择70%时，在70%、80%、90%、100%时通知)

③ 邮件或接收SMS可通过下面的通知对象设置进行设置。

通知对象设置

可以设置对于临界值通知设置的收件人和接收方式。未设置通知对象时，可能无法收到通知。

① 点击通知对象设置标签。

② 点击负责人姓名与通知方法后，点击 [添加] 按钮。

• 要添加新的邮件地址或SMS时，请点击右上方的通知对象管理。
  • 通知对象管理设置请参考MANAGEMENT > Monitoring > 详细监控使用指南 > 步骤7. 通知对象管理。

API统计图表

根据服务性质决定单位（调用次数，字符数，时间等）。

可以在AI·NAVER API > AI·NAVER API > Usage Statistics确认。

先选择应用程序后可以查看服务的统计。

将API调用次数按成功/失败区分显示，同时会显示根据各个服务的计费单位的使用量。

使用内容

在门户内My Page > 使用内容里可以确认昨天日期的使用内容。