能力提供方操作指南

在天翼开放平台进行能力接口注册,提供对外功能调用服务的合作伙伴称作平台的能力提供方,简称EP或Enabler。能力提供方既包括中国电信集团所属运营单位、各互联网产品基地、各专业子公司,也包括第三方互联网合作伙伴。平台汇聚各能力提供方所提供的开放能力接口及资源接口,由专业运营团队管理,为平台的合作开发者提供规范服务。能力提供方可登录管理门户,在线完成资料填报、能力接口上线申请、能力升级变更、能力调用统计分析等相关合作功能。目前,天翼开放平台对第三方能力提供方采用邀请制。

一、注册流程

1、申报材料提交

被邀请的EP需按平台运营方要求提交申报材料,运营方确认后与EP进行线下签约,运营方在平台备案并为EP分配EP帐号和密码,EP可在天翼开放平台平台管理页面线上补充填报信息,如图1。

图1

二、接口注册

接口注册由两个主要步骤构成,其分别为API接口注册与能力接口注册。能力提供方可通过管理界面,首先将自身的多个API接口分别注册登记到天翼开放平台平台,形成一个自身所属的API接口库,继而再在库中选择若干API,构成一个API接口的集合,并将其注册为一个能力接口。

1、注册API接口

1.1 进入API接口注册页面:

在能力提供方“个人中心”,选择左侧列表中的“API管理”选项,点击“新增API”按钮,进入创建API页面,如图2。

  

图2

1.2 完善API接口信息:

按要求补充完整API资料、参数及说明(如图3)。点击“提交”按钮,完成API创建。API提交后,可直接新建能力与其绑定。

图3

2、变更API接口

2.1 进入API接口编辑页面:

在能力提供方“个人中心”,选择左侧列表中的“API管理”选项,针对想要变更的API接口,点击“编辑”按钮,进入API接口编辑页面,如图4。

图4

2.2 变更API接口信息:

在API编辑页面对API信息做出相应地修改(如图12)。点击提交,完成API接口的变更。

图5 

3、注册能力接口

能力提供方可从自身所属的API接口库中复选若干API接口,构成一个API接口集合,并且在该API接口的集合注册登记为一个能力接口。当该注册能力接口通过了能力管控方的审核之后,即可在天翼开放平台开发者门户上正式对外发布。

3.1 进入能力接口注册页面:

能力提供方点击“能力管理”,进入能力信息页面,点击“创建能力”(如图5),或在个人中心首页点击“创建能力”(如图6),进入创建能力页面。

图5

图6

3.2 完善能力接口:

在创建能力页面,填写能力相关信息,如图7.

图7

填写能力时,点击“绑定API”按钮,对已申请的API进行绑定,如图8所示。

图8

注意事项:待审核的API,在能力上线后,也变更为“上线状态”

3.3 审核能力接口:

能力提交后,正式进入审核流程(如图9)。审核通过后,该能力变为“正常”状态(如图10)。

图9

图10 

4、变更能力接口

4.1 进入变更能力页面:

在能力信息页面,选择相应能力,点击“编辑属性”按钮,进入能力编辑页面,如图11。

图11

4.2 变更能力接口信息:

在编辑能力信息页面,更新能力信息(如图12),点击“申请能力服务变更”按钮,提交该能力进入变更申请流程。能力审核通过后,能力变更成功

注意事项:待审核能力无法进行变更

图12