用户操作

执行获取全部操作（适用于较新版本（11000 及之后）

输入以下 URL 模式

<protocal>://<hostname>:<port number>/api/v3/users

示例输出

{
"response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
],
"list_info": {
    "has_more_rows": false,
    "sort_field": "name",
    "start_index": 1,
    "sort_order": "asc",
    "row_count": 7
},
"users": [
    {
      "email_id": "guest@zoho.com",
      "purchase_approver": true,
      "ci_people_fields": {},
      "description": "软件产品的最终用户",
      "is_vipuser": false,
      "reporting_to": {
        "email_id": null,
        "name": "administrator",
        "is_vipuser": false,
        "id": "4",
        "department": null
      },
      "type": "用户",
      "citype": {
        "name": "用户",
        "id": 3
      },
      "cost_per_hour": "500.00",
      "ci_default_fields": {
        "udf_pickref_1": {
          "name": "高",
          "id": 1
        },
        "udf_pick_165": "团队成员",
        "udf_sline_164": null
      },
      "org_user_status": "ACTIVE",
      "id": "3",
      "department": {
        "site": null,
        "name": "行政",
        "id": "1"
      },
      "first_name": null,
      "profile_pic_url": null,
      "service_request_approver": true,
      "created_time": {
        "display_value": "2019 年 9 月 6 日上午 05:30",
        "value": "1567728017353"
      },
      "is_technician": false,
      "jobtitle": null,
      "mobile": "1234567890",
      "project_roles": {
        "name": "项目经理",
        "id": "3"
      },
      "last_name": null,
      "sms_mail_id": null,
      "middle_name": null,
      "ciid": "17",
      "purchase_approval_limit": "1000.00",
      "login_name": "guest",
      "phone": "8888",
      "employee_id": "888",
      "domain": {
        "name": "WORKGROUP",
        "id": "1"
      },
      "name": "访客",
      "ci_user_fields": {
        "udf_pickref_160": null,
        "udf_pickref_161": {
          "name": "administrator",
          "id": 4
        },
        "udf_sline_158": "软件分析师",
        "udf_pickref_159": {
          "site": null,
          "name": "工程",
          "id": 2
        },
        "udf_pick_163": "5 楼",
        "udf_sline_162": "12LE35"
      },
      "user_udf_fields": {
        "udf_pick_2": "支持",
        "udf_long_3": "9823881",
        "udf_sline_1": "活动",
        "udf_date_4": {
          "display_value": "2019 年 9 月 25 日下午 10:53",
          "value": "1569432180000"
        }
      },
      "status": "ACTIVE",
      "requester_allowed_to_view": null
    },
    {
      "email_id": "heather@gmail.com",
      "purchase_approver": false,
      "ci_people_fields": {},
      "description": "服务台专员",
      "is_vipuser": false,
      "reporting_to": {
        "email_id": null,
        "name": "administrator",
        "is_vipuser": false,
        "id": "4",
        "department": null
      },
      "type": "技术人员",
      "citype": {
        "name": "用户",
        "id": 3
      },
      "cost_per_hour": "12.00",
      "ci_default_fields": {
        "udf_pickref_1": {
          "name": "中",
          "id": 2
        },
        "udf_pick_165": "项目经理",
        "udf_sline_164": "IT 服务台"
      },
      "org_user_status": "ACTIVE",
      "id": "6",
      "department": {
        "site": null,
        "name": "IT 服务",
        "id": "5"
      },
      "first_name": null,
      "profile_pic_url": null,
      "service_request_approver": null,
      "created_time": {
        "display_value": "2019 年 9 月 6 日上午 05:30",
        "value": "1567728017353"
      },
      "is_technician": true,
      "jobtitle": null,
      "mobile": "9289291991",
      "project_roles": {
        "name": "项目经理",
        "id": "3"
      },
      "last_name": null,
      "sms_mail_id": "help@sms.com",
      "middle_name": null,
      "ciid": "20",
      "purchase_approval_limit": "-1.00",
      "login_name": "heather",
      "phone": "925-852-2602",
      "employee_id": "011",
      "domain": {
        "name": "ZOHOCORP",
        "id": "2"
      },
      "name": "Heather Graham",
      "ci_user_fields": {
        "udf_pickref_160": null,
        "udf_pickref_161": {
          "name": "administrator",
          "id": 4
        },
        "udf_sline_158": "测试经理",
        "udf_pickref_159": {
          "site": null,
          "name": "财务",
          "id": 4
        },
        "udf_pick_163": "底层",
        "udf_sline_162": "5FD92"
      },
      "user_udf_fields": {
        "udf_pick_2": "支持",
        "udf_long_3": "9289291991",
        "udf_sline_1": "服务台专员",
        "udf_date_4": {
          "display_value": "2019 年 9 月 9 日下午 10:55",
          "value": "1568049900000"
        }
      },
      "status": "ACTIVE"
    }
]
}

执行带条件和所需字段的获取全部操作，

输入以下 URL 模式：

<protocal>://<hostname>:<port number>/api/v3/users

示例输入

{
"list_info": {
    "sort_field": "name",
    "start_index": 1,
    "sort_order": "asc",
    "row_count": "25",
    "get_total_count": true,
    "search_fields": {
      "email_id": "guest@zoho.com"
    }
},
"fields_required": [
    "name",
    "is_technician",
    "citype",
    "login_name",
    "email_id",
    "department",
    "phone",
    "mobile",
    "jobtitle",
    "project_roles",
    "employee_id",
    "first_name",
    "middle_name",
    "last_name",
    "is_vipuser",
    "ciid"
]
}

示例输出

{
"list_info": {
    "sort_field": "name",
    "start_index": 1,
    "sort_order": "asc",
    "row_count": 1,
    "get_total_count": "true",
    "search_fields": {
      "email_id": "guest@zoho.com"
    },
    "has_more_rows": false,
    "total_count": 1
},
"response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
],
"users": [
    {
      "email_id": "guest@zoho.com",
      "is_technician": false,
      "jobtitle": null,
      "ci_people_fields": {},
      "mobile": "1234567890",
      "project_roles": {
        "name": "项目经理",
        "id": "3"
      },
      "last_name": null,
      "is_vipuser": false,
      "middle_name": null,
      "type": "用户",
      "citype": {
        "name": "用户",
        "id": 3
      },
      "ciid": "17",
      "ci_default_fields": {
        "udf_pickref_1": {
          "name": "高",
          "id": 1
        },
        "udf_pick_165": "团队成员",
        "udf_sline_164": null
      },
      "login_name": "guest",
      "phone": "8888",
      "employee_id": "888",
      "name": "访客",
      "ci_user_fields": {
        "udf_pickref_160": null,
        "udf_pickref_161": {
          "name": "administrator",
          "id": 4
        },
        "udf_sline_158": "软件分析师",
        "udf_pickref_159": {
          "site": null,
          "name": "工程",
          "id": 2
        },
        "udf_pick_163": "5 楼",
        "udf_sline_162": "12LE35"
      },
      "id": "3",
      "department": {
        "site": null,
        "name": "行政",
        "id": "1"
      },
      "first_name": null
    }
]
}

适用于较旧版本（11000 之前）

要获取与所有请求者相关的信息，请使用以下 URL 模式：

http://<servername>:<port number>/sdpapi/requester/

示例：

http://localhost:8080/sdpapi/requester/

获取所有请求者

要点：

操作名称“GET_ALL”应作为“POST 属性”发送，键为“OPERATION_NAME”。
输入值区分大小写
如果提供了多个参数，则会应用 AND 操作。
对于联系电话参数，将获取与请求者关联的所有号码（办公/手机）。
获取到的值（结果）将基于所提供的精确值；例如，您正在搜索请求者 John，而存在一位名为 Johnathan 的请求者，则不会获取到他；如果您也希望获取请求者 Johnathan，则必须在 John 后附加“*”作为后缀。例如：<value>john*</value>。前缀也适用相同规则。

注意：请输入注意，输入和输出 XML 格式已更改。但出于兼容性原因，输入操作将支持这两种格式。

输入格式

<name>loginname</name>

<value>guest</value>

</parameter>

<name>domainname</name>

</parameter>

<name>department</name>

<value>administration</value>

</parameter>

<name>sitename</name>

</parameter>

<name>contactnumber</name>

</parameter>

<name>employeeid</name>

</parameter>

<value>GUEST</value>

</parameter>

<name>email</name>

</parameter>

<name>jobtitle</name>

<value>job title</value>

</parameter>

<name>noofrows</name>

</parameter>

</Details>

</Operation>

注意：请输入注意，输入和输出 XML 格式已更改。但出于兼容性原因，输入操作将支持这两种格式。

输出格式

<name>userid</name>

</parameter>

<name>username</name>

<value>guest</value>

</parameter>

<name>emailid</name>

</parameter>

<name>department</name>

<value>Administration</value>

</parameter>

<name>sitename</name>

</parameter>

<name>domainname</name>

</parameter>

<name>employeeid</name>

</parameter>

<name>jobtitle</name>

<value>job title</value>

</parameter>

<name>landline</name>

</parameter>

<name>mobile</name>

</parameter>

</Details>

</Operation>