账户中心 退出系统
开发文档 资讯·分享 技术交流 会员登录
phpGrace GSCMS 公众号系统
接入说明

接口概述

graceSupperCMS 对应系统模块封装了对应的api接口,利用接口您可以快速实现 app 开发 ( 也可以基于此接口快速进行二次开发 ) 。

后端配置

打开文件 /api/controllers/api.php 设置 appKey , 此 key 在应用前端请求时以 header 形式传递给后端进行匹配;
<?php
/* api 接口基础控制器 */
class apiController extends grace{
    //.....
    // appKey
    protected $appKey    = 'GraceAppKey...';

前端配置

以 uni-app 开发为例,请求使用 graceUI request.js,打开 /GraceUI5/js/request/config.js :

// 配置 apiBaseUrl、appKey、token 服务url 信息
module.exports = {
	// api 基础 url
	apiBaseUrl        : 'https://域名/api/',
	getToken : (resolve, reject) => {
		// 接口请求秘钥 与后端开发人员协商格式及获取
		// 如 : 
		var appKey = 'GraceAppKey...';
		// 发起请求
		uni.request({
			// token 授权 api 服务器地址
			url      : "https://域名api/srequest/makeToken",
			// 请求秘钥
			data     : { 'appKey' : appKey },
			// 请求方式 POST
			method   : "POST",
			// headers
			header   : {'content-type' : 'application/x-www-form-urlencoded'},
			// 返回值类型
			dataType : "json",
			// 请求成功
			success  : (res) => {
				var data = res.data;
				if(data.status == 'ok'){
					resolve(data.data);
				}else{
					reject();
				}
			},
			// 请求失败
			fail     : (e) => { reject();}
		});
	}
}

graceRequest 用法

GraceRequest 为大家提供一个更简洁的、更安全的请求工具,提供了全局 token 验证机制及签名校验机制以及会员校验机制,可以大幅度增加接口交互过程的安全;
使用说明 : https://www.graceui.com/v5/info/10164-220.html