113 lines
4.2 KiB
Markdown
113 lines
4.2 KiB
Markdown
# 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**会员登录接口，生成访问令牌。
|
||
|
||
## 使用开放平台
|
||
|
||
根据平台界面菜单和提示，使用开放平台的其他功能模块。
|
||
|
||
### 开发者资料
|
||
查看和修改开发者资料。
|
||
|
||
|
||
|
||
|
||
### 修改密码
|
||
|
||
|
||
## 英文版
|
||
你可以切换语言到英文版，也可以添加其他翻译语言。
|
||
|
||
|