# 查询联系人自定义字段模板

>  获取配置中心联系人管理中的联系人字段设置，包括系统字段和自定义字段，用于查询、编辑联系人的字段映射关系建立

```
POST https://qw-openapi-tx.dustess.com/customer/v1/getCusTmpInfo?accessToken=

Content-Type: application/json
```

**接口限制**：每分钟调用600次；

**Params:**

| 字段        | 类型     | 描述        | 是否必须 |
| ----------- | -------- | ----------- | -------- |
| accessToken | `String` | accessToken | true     |

**成功响应**

| 响应参数名                            | 类型       | 说明                                            |
| ------------------------------------- | ---------- | ----------------------------------------------- |
| code                                  | `Int`      | 响应码_Allowed values: 0,1_                     |
| msg                                   | `String`   | 消息提示                                        |
| data                                  | `Object`   | 数据信息                                        |
| data.custom                           | `Object[]` | 自定义字段                                      |
| data.custom.id                        | `String`   | 字段标识id                                      |
| data.custom.name                      | `String`   | 字段名称                                        |
| data.custom.show                      | `String`   | 显示名称                                        |
| data.custom.type                      | `String`   | 字段类型  [获取附件URL访问签名](https://open.dustess.com/doc-5414386.md)                                      |
| data.custom.isBan                     | `Bool`     | 禁止编辑                                        |
| data.custom.enable                    | `Bool`     | 是否启用                                        |
| data.custom.require                   | `Bool`     | 是否必填                                        |
| data.custom.options                   | `String[]` | 选择项数组                                      |
| data.custom.relationId                | `String`   | 多级联选关联字段                                |
| data.custom.parentCanSelect           | `Bool`     | 是否可选父级，true:可选父级，false:仅选最后一级 |
| data.custom.categoryList              | `Object[]` | 分类列表                                        |
| data.custom.categoryList.categoryId   | `String`   | 分类id                                          |
| data.custom.categoryList.categoryName | `String`   | 分类名称                                        |
| data.stable                           | `Object[]` | 系统字段                                        |
| data.stable.id                        | `String`   | 字段标识id                                      |
| data.stable.name                      | `String`   | 字段名称                                        |
| data.stable.show                      | `String`   | 显示名称                                        |
| data.stable.type                      | `String`   | 字段类型                                        |
| data.stable.isBan                     | `Bool`     | 禁止编辑                                        |
| data.stable.enable                    | `Bool`     | 是否启用                                        |
| data.stable.require                   | `Bool`     | 是否必填                                        |
| data.stable.options                   | `String[]` | 选择项数组                                      |

**成功响应示例**

```json
{
  "success": true,
  "code": 0,
  "msg": "OK",
  "data": {
      "custom": [
          {
              "categoryList": [
                  {
                      "categoryId": "22712f24-e882-11ea-b79e-1111111111111",
                      "categoryName": "联系人类型2"
                  }
              ],
              "enable": true,
              "id": "field01",
              "isBan": false,
              "name": "联系人类型2的字段",
              "options": null,
              "require": true,
              "show": "联系人类型2的字段",
              "type": "text",
              "relationId" : ""
          },
          {
              "categoryList": [
                  {
                      "categoryId": "00000000-0000-0000-0000-000000000000",
                      "categoryName": "默认类型"
                  },
                  {
                      "categoryId": "11111111-111-1111-1111-1111111111111",
                      "categoryName": "联系人类型2"
                  }
              ],
              "enable": true,
              "id": "field11",
              "isBan": false,
              "name": "多选",
              "options": [
                  "蓝蓝的天空",
                  "绿绿的草原",
                 "这是我的家",
                  "erf",
                  "er",
                  "绿绿的草原12"
              ],
              "require": false,
              "show": "多选",
              "type": "checkbox"
          },
      ],
      "stable": [
          {
              "categoryList": null,
              "enable": true,
              "id": "remark",
              "isBan": true,
              "name": "备注名",
             "options": null,
              "require": true,
              "show": "备注名",
              "type": "text"
          },
          {
              "categoryList": null,
              "enable": true,
              "id": "mobiles",
              "isBan": false,
              "name": "电话",
              "options": null,
              "require": false,
              "show": "电话",
              "type": "text"
          },
      ]
  }
}
```

**错误响应示例**

```json
 {
    "success": false,
    "code": 10001,
    "msg": "system unknown error",
    "data": null
}
```


**民族数据**

```json
[{
    "id": "01",
    "name": "汉族"
}, {
    "id": "02",
    "name": "壮族"
}, {
    "id": "03",
    "name": "回族"
}, {
    "id": "04",
    "name": "满族"
}, {
    "id": "05",
    "name": "维吾尔族"
}, {
    "id": "06",
    "name": "苗族"
}, {
    "id": "07",
    "name": "彝族"
}, {
    "id": "08",
    "name": "土家族"
}, {
    "id": "09",
    "name": "藏族"
}, {
    "id": "10",
    "name": "蒙古族"
}, {
    "id": "11",
    "name": "侗族"
}, {
    "id": "12",
    "name": "布依族"
}, {
    "id": "13",
    "name": "瑶族"
}, {
    "id": "14",
    "name": "白族"
}, {
    "id": "15",
    "name": "朝鲜族"
}, {
    "id": "16",
    "name": "哈尼族"
}, {
    "id": "17",
    "name": "黎族"
}, {
    "id": "18",
    "name": "哈萨克族"
}, {
    "id": "19",
    "name": "傣族"
}, {
    "id": "20",
    "name": "畲族"
}, {
    "id": "21",
    "name": "傈僳族"
}, {
    "id": "22",
    "name": "东乡族"
}, {
    "id": "23",
    "name": "仡佬族"
}, {
    "id": "24",
    "name": "拉祜族"
}, {
    "id": "25",
    "name": "佤族"
}, {
    "id": "26",
    "name": "水族"
}, {
    "id": "27",
    "name": "纳西族"
}, {
    "id": "28",
    "name": "羌族"
}, {
    "id": "29",
    "name": "土族"
}, {
    "id": "30",
    "name": "仫佬族"
}, {
    "id": "31",
    "name": "锡伯族"
}, {
    "id": "32",
    "name": "柯尔克孜族"
}, {
    "id": "33",
    "name": "景颇族"
}, {
    "id": "34",
    "name": "达斡尔族"
}, {
    "id": "35",
    "name": "撒拉族"
}, {
    "id": "36",
    "name": "布朗族"
}, {
    "id": "37",
    "name": "毛南族"
}, {
    "id": "38",
    "name": "塔吉克族"
}, {
    "id": "39",
    "name": "普米族"
}, {
    "id": "40",
    "name": "阿昌族"
}, {
    "id": "41",
    "name": "怒族"
}, {
    "id": "42",
    "name": "鄂温克族"
}, {
    "id": "43",
    "name": "京族"
}, {
    "id": "44",
    "name": "基诺族"
}, {
    "id": "45",
    "name": "德昂族"
}, {
    "id": "46",
    "name": "保安族"
}, {
    "id": "47",
    "name": "俄罗斯族"
}, {
    "id": "48",
    "name": "裕固族"
}, {
    "id": "49",
    "name": "乌孜别克族"
}, {
    "id": "50",
    "name": "门巴族"
}, {
    "id": "51",
    "name": "鄂伦春族"
}, {
    "id": "52",
    "name": "独龙族"
}, {
    "id": "53",
    "name": "赫哲族"
}, {
    "id": "54",
    "name": "高山族"
}, {
    "id": "55",
    "name": "珞巴族"
}, {
    "id": "56",
    "name": "塔塔尔族"
}]
```