# 查询外联盟


```
POST https://qw-openapi-tx.dustess.com/external_partner/search?accessToken=
```

**使用说明**：

**请求header**

| 字段         | 值               |
| ------------ | ---------------- |
| Content-Type | application/json |

**Params:**

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

**请求参数**

| 请求参数名      | 类型       | 说明                              | 是否必须 |
| --------------- | ---------- | --------------------------------- | -------- |
| ids             | `[]string` | 外联盟 id                         | false    |
| ownerIDs        | `[]String` | 使用人 id                         | false    |
| phones          | `[]String` | 手机号                            | false    |
| createTimeStart | `int64`    | 创建时间范围的开始（Unix 时间戳） | false    |
| createTimeEnd   | `int64`    | 创建时间范围的结束（Unix 时间戳） | false    |
| page            | `int32`    | 页                                | true     |
| pageSize        | `int32`    | 每页数量                          | true     |

**请求参数示例**
`json` - Request-Example:

```json
{
    "ids": [
        "1234567"
    ],
    "ownerIDs": [
        "123"
    ],
    "phones":["13387865436"],
    "createTimeStart": 1727339289,
    "createTimeEnd": 1727339290,
    "page": 1,
    "pageSize": 10
}

```

**成功响应**

| 响应参数名                | 类型     | 说明                    |
| ------------------------- | -------- | ----------------------- |
| code                      | `Int`    | 响应码，0:成功          |
| msg                       | `String` | 消息提示                |
| success                   | `Bool`   | 成功标识                |
| data                      | `Object` | 响应结果                |
| data.count                | `int64`  | 搜索结果总数量          |
| data.data                 | []Object | 搜索到的外联盟          |
| data.data.id              | string   | 外联盟 id               |
| data.data.name            | string   | 外联盟名称              |
| data.data.phone           | string   | 电话号码                |
| data.data.attachments     | []Object | 凭证                    |
| data.data.attachments.url | string   | 凭证附件链接            |
| data.data.ownerUser       | string   | 使用人(员工ID)                  |
| data.data.enabled         | bool     | 是否已启用                  |
| data.data.approvalStatus  | string   | 审核状态                |
| data.data.createdAt       | int64    | 创建时间（Unix 时间戳） |
| data.data.updateAt        | int64    | 更新时间（Unix 时间戳） |
| data.data.createUser      | string   | 创建人员工 id               |
| data.data.updateUser      | string   | 更新人员工 id               |
| data.list.udf                                 | `Object`   | 自定义字段                   |
| data.list.udf.model_data                      | `Object[]` | 自定义字段数据集              |
| data.list.udf.model_data[].key                | `string`   | 字段业务ID                             |
| data.list.udf.model_data[].value              | `string`   | 字段值：单行文本、多行文本、日期、日期时间类型值为字符串；数字、附件、单多选、多级联选单多选的值为json序列化后的字符串；日期类型字符串格式：`2021-06-01`；日期时间类型字符串格式：`2006-01-02 15:04:05`；附件为object数组，格式：`[{"name":"企业列表.xlsx","url":"https://xxx/xxx.xlsx","size":11085,"type":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"}]`；单多选为字符串数组，格式：`["选项id"]`；多级联选单多选为字符串数组，格式：`["一级选项id/二级选项id"]` |

**成功响应示例**

```json
{
    "success": true,
    "code": 0,
    "msg": "",
    "data": {
	"count": 1,
        "data": [
            {
                "id": "1234567",
                "name": "测试外联盟",
                "phone": "13387865436"
            }
        ]
    },
    "trace_id": "81d869b0-ae7d-40e4-8d98-a14e6a941852"
}

```

**错误响应示例**

```json
{
    "success": false,
    "code": 40020,
    "msg": "param enable error ex:0|1|2",
    "data": {}
}

```