# 客户公司

Version: a2bc6a0f021ec643

模块地址：https://sandbox.maimai.dev.planahr.top/api/v1/client-library/tools；权限 clients:read / clients:write。写权限不包含读权限，均不扩大用户自身权限。

操作名：search、detail、create、update。工具名称前缀 client_library_ 不用于 POST 的 operation。

GET 加 ?operation=操作名 只取单项 schema；?view=summary 只取目录。POST 不带查询参数，使用 {operation,input} 和 Content-Type: application/json。

```bash
curl 'https://sandbox.maimai.dev.planahr.top/api/v1/client-library/tools?operation=search' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

- 先搜索避免重复；新岗位关联真实客户公司 ID，不以自由文本代替关联。

以下仅为虚构模板；ID、version 必须从真实读取结果取得，写入 requestId 为每个逻辑动作生成且重试保持不变。

### 搜索客户公司（只读）

POST /api/v1/client-library/tools

```json
{
  "operation": "search",
  "input": {
    "query": "示例公司",
    "page": 1,
    "pageSize": 20
  }
}
```