Application使用指南
  • PDF

Application使用指南

  • PDF

可在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菜单,同意条款后进行应用程序注册。

ainaver_application_1_zh(1)

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

  • 名称最多可输入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注册的应用程序名称列表,每个应用程序都可以确认如下信息。

ainaver_application_2_zh

服务分类:确认所选的服务。

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

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

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

ainaver_application_3_zh

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

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

  • 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,清零每日使用量)

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

使用上限设置

ainaver_application_4_zh

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

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

临界值通知设置

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

ainaver_application_6_zh

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

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

  • (示例:选择70%时,在70%、80%、90%、100%时通知)

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

通知对象设置

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

ainaver_application_7_zh

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

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

API统计图表

根据服务性质决定单位(调用次数,字符数,时间等)。

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

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

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

ainaver_application_5_zh

使用内容

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


本文对您有帮助吗?