user

变更历史

版本	变更内容	变更时间	变更人员
v0.01	初稿	2018-07-24	wuxw

目录

1. 首页
2. 安装部署
3. 中心服务接口协议
4. 中心服务配置文档
5. 用户服务接口协议
6. 用户服务接口测试文档
7. 商品服务接口协议
8. 商品服务接口测试文档
9. 商户服务接口协议
10. 商户服务接口测试文档
11. 评论服务接口协议
12. 评论服务接口测试文档
13. 编码生成服务接口协议
14. 编码生成服务接口测试文档

用户协议

orders节点 和 business节点在中心服务（center）中已经介绍，这里不再介绍，查看请点orders和business介绍，这里我们介绍datas节点下内容

保存用户信息

serviceCode 为 save.user.info 保存用户

父元素名称	参数名称	约束	类型	长度	描述	取值说明
datas	businessUser	1	Object	-	用户节点信息	-
businessUser	userId	1	String	30	用户ID	新增时，写-1，其他时写存在userId
businessUser	name	1	String	50	用户名称	-
businessUser	email	?	String	30	邮箱	请填写XX@YY.ZZ格式的邮箱地址
businessUser	address	?	String	200	现居住地址	XX市XX区XX路
businessUser	password	?	String	128	加密后的用户密码	请用MD5加密
businessUser	locationCd	?	String	8	用户地区	详见u_location
businessUser	age	?	int	-	用户年龄	-
businessUser	sex	?	String	1	用户性别	0表示男孩，1表示女孩
businessUser	tel	?	String	11	用户手机号	-
businessUser	level_cd	1	String	2	用户级别	关联user_level
businessUser	businessUserAttr	?	Array	-	用户属性	-
businessUserAttr	attrId	1	String	30	属性ID	新增时，写-1，其他时写存在attrId
businessUserAttr	specCd	1	String	12	规格编码	由用户服务提供
businessUserAttr	value	1	String	50	属性值

请求报文格式：

{
  "orders": {
    "appId": "外系统ID，分配得到",
    "transactionId": "100000000020180409224736000001",
    "userId": "用户ID",
    "orderTypeCd": "订单类型,查询,受理",
    "requestTime": "20180409224736",
    "remark": "备注",
    "sign": "这个服务是否要求MD5签名",
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  },
  "business": [{
    "serviceCode": "save.user.info",
    "serviceName": "保存用户信息",
    "remark": "备注",
    "datas": {
      "businessUser": {
        "userId": "-1",
        "name": "张三",
        "email": "928255095@qq.com",
        "address": "青海省西宁市城中区129号",
        "password": "ERCBHDUYFJDNDHDJDNDJDHDUDHDJDDKDK",
        "locationCd": "001",
        "age": 19,
        "sex": "0",
        "tel": "17797173943",
        "level_cd": "1",
        "businessUserAttr": [{
          "attrId":"-1",
          "specCd":"1001",
          "value":"01"
        }]
      }
    },
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  }]
}

保存用户证件信息

serviceCode 为 save.user.credentials 保存用户证件信息

父元素名称	参数名称	约束	类型	长度	描述	取值说明
datas	businessUserCredentials	1	Object	-	用户证件节点信息	-
businessUserCredentials	userId	1	String	30	用户ID	已有userId
businessUserCredentials	credentialsId	1	String	30	证件ID	新增写-1
businessUserCredentials	credentialsCd	1	String	12	证件类型	证件字典表
businessUserCredentials	value	1	String	50	证件号码	证件号码

{
  "orders": {
    "appId": "外系统ID，分配得到",
    "transactionId": "100000000020180409224736000001",
    "userId": "用户ID",
    "orderTypeCd": "订单类型,查询,受理",
    "requestTime": "20180409224736",
    "remark": "备注",
    "sign": "这个服务是否要求MD5签名",
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  },
  "business": [{
    "serviceCode": "save.user.credentials",
    "serviceName": "用户打标保存",
    "remark": "备注",
    "datas": {
      "businessUserCredentials": {
        "userId": "1019181771",
        "credentialsId": "-1",
        "credentialsCd": "1",
        "value":"632126XXXXXXXX2011"
      }
    },
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  }]
}

用户打标

serviceCode 为 save.user.tag 用户打标

父元素名称	参数名称	约束	类型	长度	描述	取值说明
datas	businessUserTag	1	Object	-	用户证件节点信息	-
businessUserTag	userId	1	String	30	用户ID	已有userId
businessUserTag	tagId	1	String	30	tagId	新增写-1
businessUserTag	tagCd	1	String	12	标签编码	-
businessUserTag	remark	1	String	200	备注	备注

{
  "orders": {
    "appId": "外系统ID，分配得到",
    "transactionId": "100000000020180409224736000001",
    "userId": "用户ID",
    "orderTypeCd": "订单类型,查询,受理",
    "requestTime": "20180409224736",
    "remark": "备注",
    "sign": "这个服务是否要求MD5签名",
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  },
  "business": [{
    "serviceCode": "save.user.tag",
    "serviceName": "用户打标保存",
    "remark": "备注",
    "datas": {
      "businessUserTag": {
        "userId": "1019181771",
        "tagId": "-1",
        "tagCd": "1019191",
        "remark": "青海省西宁市城中区129号"
      }
    },
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  }]
}

用户地址信息保存

serviceCode 为 save.user.address 用户地址信息保存

父元素名称	参数名称	约束	类型	长度	描述	取值说明
datas	businessUserAddress	1	Object	-	用户证件节点信息	-
businessUserAddress	userId	1	String	30	用户ID	已有userId
businessUserAddress	addressId	1	String	30	addressId	新增写-1
businessUserAddress	tel	11	String	30	电话	-
businessUserAddress	address	200	String	30	地址	-
businessUserAddress	postalCode	1	String	10	邮政编码	-
businessUserAddress	isDefault	1	String	1	是否为默认地址	1，表示默认地址 0 为空不是默认地址

{
  "orders": {
    "appId": "外系统ID，分配得到",
    "transactionId": "100000000020180409224736000001",
    "userId": "用户ID",
    "orderTypeCd": "订单类型,查询,受理",
    "requestTime": "20180409224736",
    "remark": "备注",
    "sign": "这个服务是否要求MD5签名",
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  },
  "business": [{
    "serviceCode": "save.user.address",
    "serviceName": "用户地址信息保存",
    "remark": "备注",
    "datas": {
      "businessUserAddress": {
        "userId": "123123",
        "addressId": "-1",
        "tel": "17797173943",
        "address": "青海省西宁市城中区129号",
        "postalCode": "810504",
        "isDefault": "0"
      }
    }
  }]
}