saveVisit.md 2.0 KB

1. 访客登记

接口功能

用户通过web端或APP访客登记接口

URL

http://api.java110.com:8008/api/visit.saveVisit

支持格式

JSON

HTTP请求方式

POST

请求参数(header部分)
参数名称 约束 类型 长度 描述 取值说明
app_id 1 String 30 应用ID Api服务分配
transaction_id 1 String 30 请求流水号 不能重复 1000000000+YYYYMMDDhhmmss+6位序列
sign 1 String - 签名 请参考签名说明
req_time 1 String - 请求时间 YYYYMMDDhhmmss
请求参数(body部分)
参数名称 约束 类型 长度 描述 取值说明
name 1 String 50 用户名称 -
email 1 String 30 邮箱地址 邮箱地址1234@xx.com
password 1 String 128 密码 加盐码md5
tel 1 String 11 手机号 11位手机号
sex ? String 1 性别 0表示男孩 1表示女孩
返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功,body内容为返回内容,

参数名称 约束 类型 长度 描述 取值说明
vName 1 String 255 访客姓名 -
visitGender 1 String 1 访客性别 -
phoneNumber 1 String 11 访客联系方式 -
visitTime 1 date - 访客拜访时间 -
举例

地址:http://api.java110.com:8008/api/visit.saveVisit

请求头信息:
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文:
{
	"departureTime": "2019-12-24 03:40:35",
	"vName": "12121",
	"visitTime": "2019-12-23 15:41:35",
	"phoneNumber": "15178832520",
	"visitCase": "212121212",
	"visitGender": "0",
	"communityId": "7020181217000001",
	"ownerId": "772019091360360003"
}
返回报文:
    成功