调用接口主要有两种方式(网转)

以下为夜曲编程人工智能部分内容

 

调用接口主要有两种方式:
直接通过网络请求或者通过封装好的SDK进行调用。

 

通过封装好的SDK调用API
 
只要AI平台将API封装到SDK里,我们就可以直接通过SDK调用对应的API。
只需安装平台提供的Python SDK,然后创建相应的客户端,就可以通过特定的方法对接口进行调用。
如图所示,课程里我们一直使用的是这种方式,无论是调用还是调试的过程都非常方便和快捷,可以节约很多时间~

 

如果决定通过SDK调用接口,那就需要评估相关编程语言的SDK文档,我们必须确保文档中至少有以下内容:

接口的能力介绍、请求接口的参数详情、返回数据的参数详情、相关的示例代码、以及请求接口时会遇到的报错情况说明。

 

举个例子,我们可以通过该页面的左侧,选择情感分析的Python语言SDK文档,它包含:
文档简介 - 这里平台提供了两种联系方式,用于处理调用接口时可能遇到的问题;
接口能力简述 - SDK里所有的接口名称和能力简述;
版本更新记录;
快速入门教程 - 如何安装Python SDK和创建客户端;
接口说明 - 不同接口的功能描述、请求参数详情、返回数据参数详情和示例代码;
错误信息 - 若请求接口时遇到报错,服务器返回的JSON文本会包含错误码和错误信息,帮助理解和解决发生的错误。

 

通过网络请求调用API
 
如果接口还未被封装到SDK里,那我们只能通过网络请求的方式来调用接口,也就需要评估API文档。
和评估SDK文档类似,我们得确保文档中至少有以下内容,且这些内容必须简单易懂:
接口的能力介绍、调用方式、相关的示例代码、以及请求接口时会遇到的报错情况说明。
 
 

 

posted @ 2022-06-01 20:03  EROEG  阅读(392)  评论(0编辑  收藏  举报