接口

字数统计: 1.3k字   |   阅读时长≈ 6分

接口：

接口文档：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
简要描述：

    项目类别保存

请求URL：

   www.xx.com/index.php

请求方式：

    POST、 GET

接口类型：

    对外接口

权限：

    只限后端用户
参数名 必选 类型 说明
pid 是 string 工程id
u 是 string 请求用户类型
mode 是 string 接口调用方式
categoryId 是 string 类别Id
title 否 string 类别名称
desc 否 string 类别描述
editType 是 string 1保存 2编辑
state 是 int 0停用 1启用

返回示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{   
	"message": "",    
   "error": "",   
   "categoryInfo":
      [
        {
        "categoryId": '项目类别编号',
        "categoryTitle": '项目类别名称',
        "categoryDesc": "项目类别描述"
        "state": 0
        }，
       ｛
        ......
        ｝,
      ],
   "opResult": 1   //删除，修改，添加会有
}

返回参数说明

参数名 类型 说明
message string 友好错误提示
error string 系统错误提示
categoryInfo 数组 项目列表
categoryId string 项目类别编号
categoryTitle string 项目类别名称
categoryDesc string 项目类别描述
state int 状态 0停用 1启用

规则

写接口：

1.引入公共函数
1
require_once("config/configGlobal.php");
2.参数

​ 公共参数

​ 参数描述（状态）

1
2
3
4
5
6
7
8
9
$pid      = $C->pid; //工程ID											\
$u        = $C->u; //请求用户类型										 \	公共参数
$mode      = $mode; //接口调用方式 									 /

$categoryId = _request('categoryId'); //类别Id
$title    = _request('title'); //类别名称
$desc     = _request('desc'); //类别描述
$editType   = _request('editType'); //1保存 2编辑
$state    = _request('state'); //项目类别状态  0停用 1启用
3.定义错误返回 error和message
1
2
3
4
$errStr   = "";
$message  = "";
$categoryInfo = "";
$opResult = 0;
4.参数是否必传参
1
2
3
4
5
6
7
if ($categoryId == '') {
 $message = "类别Id不能为空！";
} else if ($editType == '') {
    $message = "操作类型不能为空！";
} else if ($state == '') {
    $message = "项目类别状态不能为空！";
}
5.写法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
//查询	
if($message){
	if ($editType == '1'){
         //categoryId不允许重复
         $sql = "select  * from thesis_category_info where categoryId = '$categoryId' " ;     
            try {
                $res = $C->db()->query($sql);
            }
            catch (Exception $e) {
                $C->dieApiError($e->getMessage(), '查询失败！', $sql, 'categorySave.php');
            } 
            if (!empty($res)) {
                $message = "项目类别Id不允许重复";
            }
        }
}
//添加
if ($message == '') {
    //保存数据库
    if ($editType == '1'){
     $sql = " insert into 
     	xxxx(categoryId,title,desc)
     	values('$categoryId','$title','$desc')" ;     
        try {
            $res = $C->db()->execute($sql);
        }
        catch (Exception $e) {
            $C->dieApiError($e->getMessage(), '添加失败！', $sql, 'categorySave.php');
        } 
    } 
    $opResult = 1;
}

//修改
if ($message == '') {  if ($editType == '2'){
     // 编辑时不允许编辑 categoryId
     $sql = " update xxxxx
     	set title='$title',desc='$desc' 
    	 where categoryId = '$categoryId' " ;     
        try {
            $res = $C->db()->execute($sql);
            $opResult = 1;
        }
        catch (Exception $e) {
            $C->dieApiError($e->getMessage(), '编辑失败！', $sql, 'categorySave.php');
        }  }
   }

//多条
   $sql = "xxx";
   array_push($sqlArr, $sql);
   $sql = "xxxx";
   array_push($sqlArr, $sql);
if ($message == "") {
       if (count($sqlArr) > 0) {
           try {
               if ($C->db()->execTransaction($sqlArr)) {
                   $opResult = 1;
               }
           }
           catch (PDOException $e) {
               $errStr = iconv('GBK', 'UTF-8', $e->getMessage());
               $C->dieApiError($errStr, '系统错误');
           }
       }
   }
//query 拿来执行 select 更好一些，execute 哪里执行 update | insert | delete 更好些！

6.接口中调用接口（跨域）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
3、获取截止日期调用产品子系统对外接口simpleproductinfo.asp，其输入参数productid=专业id。日期比较按天比较即可。
if ($message == '') {
    $url  = $sysDomain["productSysDomain"] . "/intf/simpleproductinfo";
    $data = array(
        "pid" => $pid,
        "mode" => "s",
        "u" => $userPort,
        "i_uid" => $uid,
        "i_u_p" => $userPort,
        "i_time" => date("Y-m-d@H:i:s", time()),
        "productid" => $specId
        
        
    );
    
    $data["i_sign"] = $C->buildSign($data);
    $json           = curlPost($url, arrayStringfly($data));
    $resObj         = json_decode($json, true);
    
    if (!empty($resObj)) {
        if (empty($resObj['error'])) {
            if ($resObj['totalResults'] > 0) {
                $endDate = $resObj['simpleProductInfos'][0]['endDate'];
            } else {
                $message = "获取截止日期失败!";
            }
            
        } else {
            $message = "获取截止日期失败";
            $errStr  = $resObj['error'];
        }
    } else {
        $message = "获取截止日期失败";
    }
    
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// 4、获取微专业的课程调用调用教学子系统对外接口termproduct.asp，其输入参数planid=专业id。
if ($message == '') {
    $url  = $sysDomain["TeachSysDomain"] . "/intf/termproduct";
    $data = array(
        "pid" => $pid,
        "mode" => "s",
        "u" => $userPort,
        "i_uid" => $uid,
        "i_u_p" => $userPort,
        "i_time" => date("Y-m-d@H:i:s", time()),
        "planid" => $specId
        
    );
    
    $data["i_sign"] = $C->buildSign($data);
    $json           = curlPost($url, arrayStringfly($data));
    $resObj         = json_decode($json, true);
    
    
    if (!empty($resObj)) {
            if (empty($resObj['error'])) {
                if ($resObj['totalItems'] > 0) {
                    $productId = '';
                    $resP      = $resObj['termproducts'];
                    for ($i = 0; $i < count($resP); $i++) {
                        $productId .= "'" . $resP[$i]['productid'] . "',";
                    }

                    $productId = rtrim($productId, ",");
                } else {
                    $message = "1获取课程失败";
                }

            } else {
                $message = "2获取课程失败";
                $errStr  = $resObj['error'];

            }
        } else {
            $message = "3获取课程失败";
        }

    }

7.返回值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
//分页显示
if ($message == '' && !empty($res)) {
    $totalRecords = count($res);
    $res          = $C->getPage($res, $pageNo, $pageSize);
    $totalItems   = count($res);
}

if ($errStr == "") {
    $errStr = $message;
}
$jsonstr = array(
    "error" => $errStr,
    "message" => $message,
    "opResult" => $opResult
);
$C->echoApiResult($jsonstr);

end

赏

谢谢你请我吃糖果

支付宝
微信

扫一扫，分享到微信

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia-plus根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

主要涉及技术