用户操作

执行 "获取全部 "操作（对于较新版本（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": "End User of the software product",
      "is_vipuser": false,
      "reporting_to": {
        "email_id": null,
        "name": "administrator",
        "is_vipuser": false,
        "id": "4",
        "department": null
      },
      "type": "User",
      "citype": {
        "name": "User",
        "id": 3
      },
      "cost_per_hour": "500.00",
      "ci_default_fields": {
        "udf_pickref_1": {
          "name": "High",
          "id": 1
        },
        "udf_pick_165": "Team member",
        "udf_sline_164": null
      },
      "org_user_status": "ACTIVE",
      "id": "3",
      "department": {
        "site": null,
        "name": "Administration",
        "id": "1"
      },
      "first_name": null,
      "profile_pic_url": null,
      "service_request_approver": true,
      "created_time": {
        "display_value": "Sep 6, 2019 05:30 AM",
        "value": "1567728017353"
      },
      "is_technician": false,
      "jobtitle": null,
      "mobile": "1234567890",
      "project_roles": {
        "name": "Project Manager",
        "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": "Guest",
      "ci_user_fields": {
        "udf_pickref_160": null,
        "udf_pickref_161": {
          "name": "administrator",
          "id": 4
        },
        "udf_sline_158": "Software analyst",
        "udf_pickref_159": {
          "site": null,
          "name": "Engineering",
          "id": 2
        },
        "udf_pick_163": "5 th floor",
        "udf_sline_162": "12LE35"
      },
      "user_udf_fields": {
        "udf_pick_2": "support",
        "udf_long_3": "9823881",
        "udf_sline_1": "Active",
        "udf_date_4": {
          "display_value": "Sep 25, 2019 10:53 PM",
          "value": "1569432180000"
        }
      },
      "status": "ACTIVE",
      "requester_allowed_to_view": null
    },
    {
      "email_id": "heather@gmail.com",
      "purchase_approver": false,
      "ci_people_fields": {},
      "description": "Help Desk Executive",
      "is_vipuser": false,
      "reporting_to": {
        "email_id": null,
        "name": "administrator",
        "is_vipuser": false,
        "id": "4",
        "department": null
      },
      "type": "Technician",
      "citype": {
        "name": "User",
        "id": 3
      },
      "cost_per_hour": "12.00",
      "ci_default_fields": {
        "udf_pickref_1": {
          "name": "Medium",
          "id": 2
        },
        "udf_pick_165": "Project Manager",
        "udf_sline_164": "IT Help Desk"
      },
      "org_user_status": "ACTIVE",
      "id": "6",
      "department": {
        "site": null,
        "name": "IT Services",
        "id": "5"
      },
      "first_name": null,
      "profile_pic_url": null,
      "service_request_approver": null,
      "created_time": {
        "display_value": "Sep 6, 2019 05:30 AM",
        "value": "1567728017353"
      },
      "is_technician": true,
      "jobtitle": null,
      "mobile": "9289291991",
      "project_roles": {
        "name": "Project Manager",
        "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": "Testing manager",
        "udf_pickref_159": {
          "site": null,
          "name": "Finance",
          "id": 4
        },
        "udf_pick_163": "Ground Floor",
        "udf_sline_162": "5FD92"
      },
      "user_udf_fields": {
        "udf_pick_2": "support",
        "udf_long_3": "9289291991",
        "udf_sline_1": "Help Desk Executive",
        "udf_date_4": {
          "display_value": "Sep 9, 2019 10:55 PM",
          "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"
]
}

Sample Output

{
"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": "Project Manager",
        "id": "3"
      },
      "last_name": null,
      "is_vipuser": false,
      "middle_name": null,
      "type": "User",
      "citype": {
        "name": "User",
        "id": 3
      },
      "ciid": "17",
      "ci_default_fields": {
        "udf_pickref_1": {
          "name": "High",
          "id": 1
        },
        "udf_pick_165": "Team member",
        "udf_sline_164": null
      },
      "login_name": "guest",
      "phone": "8888",
      "employee_id": "888",
      "name": "Guest",
      "ci_user_fields": {
        "udf_pickref_160": null,
        "udf_pickref_161": {
          "name": "administrator",
          "id": 4
        },
        "udf_sline_158": "Software analyst",
        "udf_pickref_159": {
          "site": null,
          "name": "Engineering",
          "id": 2
        },
        "udf_pick_163": "5 th floor",
        "udf_sline_162": "12LE35"
      },
      "id": "3",
      "department": {
        "site": null,
        "name": "Administration",
        "id": "1"
      },
      "first_name": null
    }
]
}

旧版本（11000 之前）

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

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

示例

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

获取所有请求者

关键字

操作名称 “GET_ALL ”应作为 “POST attribute”发送，关键字为 “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>