# OpenApi

**Repository Path**: bim_studio/open-api

## Basic Information

- **Project Name**: OpenApi
- **Description**: 对外接口
- **Primary Language**: Unknown
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-22
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenApi

#### 介绍
对外接口

#### 软件架构
无


#### 1、门禁数据传输

Api地址：https://ddwserver.bimnb.com/open/entranceGuard

请求参数
| 参数 | 类型 | 说明 |
| :-----| ----: | :----: |
| openid | String | 平台分配的openid 用来标识项目唯一id，区分大小写 |
| data | JsonArray String | 第三方接入的数据,JsonArray 使用json encode进行编码|

返回参数
| 参数 | 类型 | 说明 |
| :-----| ----: | :----: |
| code | int | 返回0，表示成功 |
| msg | String | 返回成功 或者 失败原因 |
| data | Json | 成功 返回json数据  |
| time | int | 10位时间戳，接口返回服务器时间  |

请求数据(data)json说明：注意 data 字段json数据需 json encode 将数据编码成string字符串传递

| 参数 | 类型 | 说明 |
| :-----| ----: | :----: |
| name | String | 进场人员姓名 |
| work_type | String | 人员工种 |
| work_class | String | 所属班组  |
| idcard | String | 身份证号  |
| location | String | 工地名称  |
| tel | String | 联系电话  |
| type | int | 数据类型   参数：1 人员进场   2 人员离场 |
| in_time | int | 10位时间戳  type为1时为进场时间，type为2时为离场时间|
| mode | int | 数据方式   参数：1、录入 2、人脸 3、指纹 |

```
 [{
		"name": "张三",
		"work_type": "施工",
		"work_class": "2组",
		"idcard": "50023000000000",
		"location": "东升和府",
		"tel": "188888800000",
		"type": 1,
		"in_time": "1598035402",
		"mode": 1
	}, {
		"name": "李四",
		"work_type": "焊工",
		"work_class": "3组",
		"idcard": "50023000000001",
		"location": "东升和府",
		"tel": "188888800001",
		"type": 1,
		"in_time": "1598035402",
		"mode": 2
	}]
```
成功返回


```
{
    "code": 0,
    "msg": "SUCCESS",
    "time": 1598082659,
    "data": [
        {
            "name": "张三",
            "work_type": "施工",
            "work_class": "2组",
            "idcard": "50023000000000",
            "location": "东升和府",
            "tel": "188888800000",
            "type": 1,
            "in_time": "1598035402",
            "mode": 1,
            "pid": 15,
            "create_time": 1598082659,
            "create_user": 0,
            "id": "83"
        },
        {
            "name": "李四",
            "work_type": "焊工",
            "work_class": "3组",
            "idcard": "50023000000001",
            "location": "东升和府",
            "tel": "188888800001",
            "type": 1,
            "in_time": "1598035402",
            "mode": 2,
            "pid": 15,
            "create_time": 1598082659,
            "create_user": 0,
            "id": "84"
        }
    ]
}


```