Files
phalapi-pro/public/wiki/platform.md
2022-03-21 11:16:38 +08:00

4.2 KiB
Raw Blame History

Platform开放平台使用手册

开放平台是提供给开发者使用的平台。

新手开发者的主要使用流程是:

访问开放平台

假设配置的域名是http://open.phalapi.net那么管理后台的地址是

http://open.phalapi.net/platform/

或者通过在线接口文档页面,点击【开放平台】直接进入,例如:

注册开发者账号

进入开发者注册页面,按提示填写注册信息,然后提交。

登录开放平台

注册成功后,进入开放平台登录页面,输入登录账号和密码,然后登录。

创建应用

进入【应用管理】-【我的应用】-【创建新应用】,按要求填写相关信息,确认提交,然后等待管理员审核。

填写应用信息:

创建新应用后等待管理员审核。

查看应用密钥:

应用审核通过后,可查看应用的接口权限。

查看接口权限

在管理员分配接口权限后就可以调用需要的开放接口API。

调用开放接口

开发者在调用开放接口前,需要先注册开发者账号,创建新的应用并等待管理员审核通过,并且只能调用已分配权限的接口。

获取接口访问令牌

首先开发者需要根据已申请的app_key和app_secret创建新的访问令牌。可以使用接口App.Auth.ApplyToken 申请访问令牌接口。

界面化操作指引如下进入在线接口文档选择【App.Auth.ApplyToken】。

输入应用的app_key和密钥获取令牌

申请成功后接口会返回access_token访问令牌以及expire_at有效时间。

{
    "ret": 200,
    "data": {
        "access_token": "访问令牌",
        "expire_at": 1580442248
    },
    "msg": ""
}

对比三种获取令牌的方式:

接口 应用app_key 应用密钥 会员登录账号 会员登录密码 备注
App.Auth.ApplyToken 需要 需要 不需要 不需要 可指定uid
App.Auth.UserLogin 不需要 不需要 需要 需要 可指定app_key
App.Auth.AppUserLogin 需要 需要 需要 需要 自动绑定uid和app_key

调用开放接口

接下来就可以根据access_token访问令牌访问其他的开放接口。

需要注意的是,如果部分开放接口需要会员登录,此时开发者应使用App.User.UserLogin会员登录接口根据会员登录账号、密码和app_key生成一个带有会员登录态的访问令牌。

温馨提示:如果开放接口需要检测会员登录态,开发者应用需要调用App.User.UserLogin会员登录接口,生成访问令牌。

使用开放平台

根据平台界面菜单和提示,使用开放平台的其他功能模块。

开发者资料

查看和修改开发者资料。

修改密码

英文版

你可以切换语言到英文版,也可以添加其他翻译语言。