请求工作日志

帮助您跟踪和记录团队成员完成的工作。

属性

id （长整型）
工作日志的唯一 ID

所有者 （用户）
工作日志的所有者

描述 （html）
关于工作日志的描述。

开始时间 （日期时间）
工作日志开始的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

结束时间 （日期时间）
工作日志结束的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

记录时间 （日期时间）
工作日志创建的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

更多属性 全部展开

兑换率 （双精度）

使用的货币兑换率

include_nonoperational_hours (boolean)

指示是否包含非工作时间。

mark_first_response (boolean)

指示在为请求/工单添加工作日志时是否设置响应日期。

worklog_type (worklog_type)

工作日志类型允许您记录技术人员工作的不同模式。

created_by （用户）read only

创建工作日志的用户

total_charge (cost)read only

与工作日志相关的总费用

total_charge (cost)

示例

{
  "total_charge": {
    "display_value": "50",
    "currency_symbol": "$",
    "value": 30,
    "secondary_currency": {
      "display_value": 100,
      "currency_symbol": "Rs.",
      "value": 100
    }
  }
}

time_spent (timediff)

以小时、分钟和秒为单位的花费时间。

other_charge (cost)

除技术人员费用外的额外费用。

other_charge (cost)

示例

{
  "other_charge": {
    "display_value": "30",
    "currency_symbol": "$",
    "value": "30",
    "secondary_currency": {
      "display_value": "60",
      "currency_symbol": "Rs.",
      "value": "60"
    }
  }
}

tech_charge (cost)

与工作日志相关的技术人员费用。

tech_charge (cost)

示例

{
  "tech_charge": {
    "display_value": "20",
    "currency_symbol": "$",
    "value": "20",
    "secondary_currency": {
      "display_value": "40",
      "currency_symbol": "Rs.",
      "value": "40"
    }
  }
}

添加请求工作日志

此操作帮助您添加请求工作日志。

必填字段：owner

Url

<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs

属性

id （长整型）
工作日志的唯一 ID

所有者 （用户）
工作日志的所有者

描述 （html）
关于工作日志的描述。

开始时间 （日期时间）
工作日志开始的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

结束时间 （日期时间）
工作日志结束的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

记录时间 （日期时间）
工作日志创建的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

更多属性 全部展开

兑换率 （双精度）

使用的货币兑换率

include_nonoperational_hours (boolean)

指示是否包含非工作时间。

mark_first_response (boolean)

指示在为请求/工单添加工作日志时是否设置响应日期。

currency (currency)

指示添加该工作日志时使用的货币。

currency (currency)
指示添加该工作日志时使用的货币。

示例

{
  "currency": {
    "symbol": "$",
    "code": "USD",
    "exchange_rate": "1",
    "is_frequent": true,
    "name": "US Dollar",
    "id": "2000000004427"
  }
}

worklog_type (worklog_type)

工作日志类型允许您记录技术人员工作的不同模式。

created_by （用户）read only

创建工作日志的用户

total_charge (cost)read only

与工作日志相关的总费用

total_charge (cost)

示例

{
  "total_charge": {
    "display_value": "50",
    "currency_symbol": "$",
    "value": 30,
    "secondary_currency": {
      "display_value": 100,
      "currency_symbol": "Rs.",
      "value": 100
    }
  }
}

time_spent (timediff)

以小时、分钟和秒为单位的花费时间。

other_charge (cost)

除技术人员费用外的额外费用。

other_charge (cost)

示例

{
  "other_charge": {
    "display_value": "30",
    "currency_symbol": "$",
    "value": "30",
    "secondary_currency": {
      "display_value": "60",
      "currency_symbol": "Rs.",
      "value": "60"
    }
  }
}

tech_charge (cost)

与工作日志相关的技术人员费用。

tech_charge (cost)

示例

{
  "tech_charge": {
    "display_value": "20",
    "currency_symbol": "$",
    "value": "20",
    "secondary_currency": {
      "display_value": "40",
      "currency_symbol": "Rs.",
      "value": "40"
    }
  }
}

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='   {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data =    {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
    {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response

Python

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''    {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "worklog": {
        "owner": {
            "email_id": "test@zoho.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": "1234567890",
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "10.0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "2000000040132",
                "is_default": true
            },
            "phone": "22",
            "employee_id": null,
            "name": "Maverick",
            "id": "2000000040351",
            "is_vip_user": false,
            "department": null,
            "first_name": "Maverick",
            "job_title": null
        },
        "include_nonoperational_hours": true,
        "exchange_rate": "1",
        "end_time": {
            "display_value": "Apr 24, 2025 09:15 AM",
            "value": "1745466355256"
        },
        "description": "Added worklog",
        "other_charge": {
            "display_value": "12.00",
            "currency_symbol": "$",
            "value": 12,
            "secondary_currency": {
                "display_value": "12.00",
                "currency_symbol": "$",
                "value": 12
            }
        },
        "total_charge": {
            "display_value": "132.00",
            "currency_symbol": "$",
            "value": 132,
            "secondary_currency": {
                "display_value": "132.00",
                "currency_symbol": "$",
                "value": 132
            }
        },
        "created_by": {
            "email_id": "test@zoho.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": "1234567890",
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "10",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "2000000040132",
                "is_default": true
            },
            "phone": "22",
            "employee_id": null,
            "name": "Maverick",
            "id": "2000000040351",
            "is_vip_user": false,
            "department": null,
            "first_name": "Maverick",
            "job_title": null
        },
        "recorded_time": {
            "display_value": "Apr 24, 2025 09:16 AM",
            "value": "1745466374289"
        },
        "time_spent": {
            "hours": "12",
            "minutes": "0",
            "value": "43200000"
        },
        "tech_charge": {
            "display_value": "120.00",
            "currency_symbol": "$",
            "value": 120,
            "secondary_currency": {
                "display_value": "120.00",
                "currency_symbol": "$",
                "value": 120
            }
        },
        "start_time": {
            "display_value": "Apr 23, 2025 09:15 PM",
            "value": "1745423155256"
        },
        "worklog_type": null,
        "currency": {
            "symbol": "$",
            "code": "USD",
            "deleted": false,
            "exchange_rate": "1",
            "name": "US Dollar",
            "id": "2000000004427"
        },
        "id": "200000005987"
    }
}

编辑请求工作日志

此操作帮助您更新请求工作日志。

Url

<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}

属性

id （长整型）
工作日志的唯一 ID

所有者 （用户）
工作日志的所有者

描述 （html）
关于工作日志的描述。

开始时间 （日期时间）
工作日志开始的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

结束时间 （日期时间）
工作日志结束的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

记录时间 （日期时间）
工作日志创建的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

更多属性 全部展开

兑换率 （双精度）

使用的货币兑换率

include_nonoperational_hours (boolean)

指示是否包含非工作时间。

mark_first_response (boolean)

指示在为请求/工单添加工作日志时是否设置响应日期。

currency (currency)

指示添加该工作日志时使用的货币。

currency (currency)
指示添加该工作日志时使用的货币。

示例

{
  "currency": {
    "symbol": "$",
    "code": "USD",
    "exchange_rate": "1",
    "is_frequent": true,
    "name": "US Dollar",
    "id": "2000000004427"
  }
}

worklog_type (worklog_type)

工作日志类型允许您记录技术人员工作的不同模式。

created_by （用户）read only

创建工作日志的用户

total_charge (cost)read only

与工作日志相关的总费用

total_charge (cost)

示例

{
  "total_charge": {
    "display_value": "50",
    "currency_symbol": "$",
    "value": 30,
    "secondary_currency": {
      "display_value": 100,
      "currency_symbol": "Rs.",
      "value": 100
    }
  }
}

time_spent (timediff)

以小时、分钟和秒为单位的花费时间。

other_charge (cost)

除技术人员费用外的额外费用。

other_charge (cost)

示例

{
  "other_charge": {
    "display_value": "30",
    "currency_symbol": "$",
    "value": "30",
    "secondary_currency": {
      "display_value": "60",
      "currency_symbol": "Rs.",
      "value": "60"
    }
  }
}

tech_charge (cost)

与工作日志相关的技术人员费用。

tech_charge (cost)

示例

{
  "tech_charge": {
    "display_value": "20",
    "currency_symbol": "$",
    "value": "20",
    "secondary_currency": {
      "display_value": "40",
      "currency_symbol": "Rs.",
      "value": "40"
    }
  }
}

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='   {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data =    {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
    {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response

Python

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''    {
  "worklog": {
    "end_time": {
      "value": 1745466355256
    },
    "other_charge": {
      "secondary_currency": {
        "value": "12"
      },
      "value": "12"
    },
    "tech_charge": {
      "secondary_currency": {
        "value": "120"
      },
      "value": "120"
    },
    "include_nonoperational_hours": true,
    "owner": {
      "id": "2000000040351"
    },
    "currency": {
      "id": "2000000004427"
    },
    "start_time": {
      "value": 1745423155256
    },
    "time_spent": {
      "hours": "12",
      "minutes": "0"
    },
    "exchange_rate": 1,
    "mark_first_response": false
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "worklog": {
        "owner": {
            "email_id": "test@zoho.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": "1234567890",
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "10.0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "2000000040132",
                "is_default": true
            },
            "phone": "22",
            "employee_id": null,
            "name": "Maverick",
            "id": "2000000040351",
            "is_vip_user": false,
            "department": null,
            "first_name": "Maverick",
            "job_title": null
        },
        "include_nonoperational_hours": true,
        "exchange_rate": "1",
        "end_time": {
            "display_value": "Apr 24, 2025 09:15 AM",
            "value": "1745466355256"
        },
        "description": "Added worklog",
        "other_charge": {
            "display_value": "12.00",
            "currency_symbol": "$",
            "value": 12,
            "secondary_currency": {
                "display_value": "12.00",
                "currency_symbol": "$",
                "value": 12
            }
        },
        "total_charge": {
            "display_value": "132.00",
            "currency_symbol": "$",
            "value": 132,
            "secondary_currency": {
                "display_value": "132.00",
                "currency_symbol": "$",
                "value": 132
            }
        },
        "created_by": {
            "email_id": "test@zoho.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": "1234567890",
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "10",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "2000000040132",
                "is_default": true
            },
            "phone": "22",
            "employee_id": null,
            "name": "Maverick",
            "id": "2000000040351",
            "is_vip_user": false,
            "department": null,
            "first_name": "Maverick",
            "job_title": null
        },
        "recorded_time": {
            "display_value": "Apr 24, 2025 09:16 AM",
            "value": "1745466374289"
        },
        "time_spent": {
            "hours": "12",
            "minutes": "0",
            "value": "43200000"
        },
        "tech_charge": {
            "display_value": "120.00",
            "currency_symbol": "$",
            "value": 120,
            "secondary_currency": {
                "display_value": "120.00",
                "currency_symbol": "$",
                "value": 120
            }
        },
        "start_time": {
            "display_value": "Apr 23, 2025 09:15 PM",
            "value": "1745423155256"
        },
        "worklog_type": null,
        "currency": {
            "symbol": "$",
            "code": "USD",
            "deleted": false,
            "exchange_rate": "1",
            "name": "US Dollar",
            "id": "2000000004427"
        },
        "id": "200000005987"
    }
}

获取请求工作日志

此操作帮助您获取请求工作日志。

Url

<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}

属性

id （长整型）
工作日志的唯一 ID

所有者 （用户）
工作日志的所有者

描述 （html）
关于工作日志的描述。

开始时间 （日期时间）
工作日志开始的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

结束时间 （日期时间）
工作日志结束的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

记录时间 （日期时间）
工作日志创建的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

更多属性 全部展开

兑换率 （双精度）

使用的货币兑换率

include_nonoperational_hours (boolean)

指示是否包含非工作时间。

mark_first_response (boolean)

指示在为请求/工单添加工作日志时是否设置响应日期。

currency (currency)

指示添加该工作日志时使用的货币。

currency (currency)
指示添加该工作日志时使用的货币。

示例

{
  "currency": {
    "symbol": "$",
    "code": "USD",
    "exchange_rate": "1",
    "is_frequent": true,
    "name": "US Dollar",
    "id": "2000000004427"
  }
}

worklog_type (worklog_type)

工作日志类型允许您记录技术人员工作的不同模式。

created_by （用户）read only

创建工作日志的用户

total_charge (cost)read only

与工作日志相关的总费用

total_charge (cost)

示例

{
  "total_charge": {
    "display_value": "50",
    "currency_symbol": "$",
    "value": 30,
    "secondary_currency": {
      "display_value": 100,
      "currency_symbol": "Rs.",
      "value": 100
    }
  }
}

time_spent (timediff)

以小时、分钟和秒为单位的花费时间。

other_charge (cost)

除技术人员费用外的额外费用。

other_charge (cost)

示例

{
  "other_charge": {
    "display_value": "30",
    "currency_symbol": "$",
    "value": "30",
    "secondary_currency": {
      "display_value": "60",
      "currency_symbol": "Rs.",
      "value": "60"
    }
  }
}

tech_charge (cost)

与工作日志相关的技术人员费用。

tech_charge (cost)

示例

{
  "tech_charge": {
    "display_value": "20",
    "currency_symbol": "$",
    "value": "20",
    "secondary_currency": {
      "display_value": "40",
      "currency_symbol": "Rs.",
      "value": "40"
    }
  }
}

Curl

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response

Python

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "worklog": {
        "owner": {
            "email_id": "test@zoho.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": "1234567890",
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "10.0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "2000000040132",
                "is_default": true
            },
            "phone": "22",
            "employee_id": null,
            "name": "Maverick",
            "id": "2000000040351",
            "is_vip_user": false,
            "department": null,
            "first_name": "Maverick",
            "job_title": null
        },
        "include_nonoperational_hours": true,
        "exchange_rate": "1",
        "end_time": {
            "display_value": "Apr 24, 2025 09:15 AM",
            "value": "1745466355256"
        },
        "description": "Added worklog",
        "other_charge": {
            "display_value": "12.00",
            "currency_symbol": "$",
            "value": 12,
            "secondary_currency": {
                "display_value": "12.00",
                "currency_symbol": "$",
                "value": 12
            }
        },
        "total_charge": {
            "display_value": "132.00",
            "currency_symbol": "$",
            "value": 132,
            "secondary_currency": {
                "display_value": "132.00",
                "currency_symbol": "$",
                "value": 132
            }
        },
        "created_by": {
            "email_id": "test@zoho.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": "1234567890",
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "10",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "2000000040132",
                "is_default": true
            },
            "phone": "22",
            "employee_id": null,
            "name": "Maverick",
            "id": "2000000040351",
            "is_vip_user": false,
            "department": null,
            "first_name": "Maverick",
            "job_title": null
        },
        "recorded_time": {
            "display_value": "Apr 24, 2025 09:16 AM",
            "value": "1745466374289"
        },
        "time_spent": {
            "hours": "12",
            "minutes": "0",
            "value": "43200000"
        },
        "tech_charge": {
            "display_value": "120.00",
            "currency_symbol": "$",
            "value": 120,
            "secondary_currency": {
                "display_value": "120.00",
                "currency_symbol": "$",
                "value": 120
            }
        },
        "start_time": {
            "display_value": "Apr 23, 2025 09:15 PM",
            "value": "1745423155256"
        },
        "worklog_type": null,
        "currency": {
            "symbol": "$",
            "code": "USD",
            "deleted": false,
            "exchange_rate": "1",
            "name": "US Dollar",
            "id": "2000000004427"
        },
        "id": "200000005987"
    }
}

获取请求工作日志列表

此操作帮助您获取所有请求工作日志。

Url

<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs

属性

id （长整型）
工作日志的唯一 ID

所有者 （用户）
工作日志的所有者

描述 （html）
关于工作日志的描述。

开始时间 （日期时间）
工作日志开始的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

结束时间 （日期时间）
工作日志结束的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

记录时间 （日期时间）
工作日志创建的日期和时间。JSON 对象包含“value”（毫秒数）和“display_value”（标准日期格式）。

更多属性 全部展开

兑换率 （双精度）

使用的货币兑换率

include_nonoperational_hours (boolean)

指示是否包含非工作时间。

mark_first_response (boolean)

指示在为请求/工单添加工作日志时是否设置响应日期。

currency (currency)

指示添加该工作日志时使用的货币。

currency (currency)
指示添加该工作日志时使用的货币。

示例

{
  "currency": {
    "symbol": "$",
    "code": "USD",
    "exchange_rate": "1",
    "is_frequent": true,
    "name": "US Dollar",
    "id": "2000000004427"
  }
}

worklog_type (worklog_type)

工作日志类型允许您记录技术人员工作的不同模式。

created_by （用户）read only

创建工作日志的用户

total_charge (cost)read only

与工作日志相关的总费用

total_charge (cost)

示例

{
  "total_charge": {
    "display_value": "50",
    "currency_symbol": "$",
    "value": 30,
    "secondary_currency": {
      "display_value": 100,
      "currency_symbol": "Rs.",
      "value": 100
    }
  }
}

time_spent (timediff)

以小时、分钟和秒为单位的花费时间。

other_charge (cost)

除技术人员费用外的额外费用。

other_charge (cost)

示例

{
  "other_charge": {
    "display_value": "30",
    "currency_symbol": "$",
    "value": "30",
    "secondary_currency": {
      "display_value": "60",
      "currency_symbol": "Rs.",
      "value": "60"
    }
  }
}

tech_charge (cost)

与工作日志相关的技术人员费用。

tech_charge (cost)

示例

{
  "tech_charge": {
    "display_value": "20",
    "currency_symbol": "$",
    "value": "20",
    "secondary_currency": {
      "display_value": "40",
      "currency_symbol": "Rs.",
      "value": "40"
    }
  }
}

Curl

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data='{"list_info":{"row_count":"100","start_index":"1","sort_field":"created_time","sort_order":"desc"}}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {"list_info":{"row_count":"100","start_index":"1","sort_field":"created_time","sort_order":"desc"}};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{"list_info":{"row_count":"100","start_index":"1","sort_field":"created_time","sort_order":"desc"}}'@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response

Python

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{"list_info":{"row_count":"100","start_index":"1","sort_field":"created_time","sort_order":"desc"}}'''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "row_count": 1
    },
    "worklogs": [
        {
            "owner": {
                "email_id": "test@zoho.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": "1234567890",
                "last_name": null,
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "10.0",
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "2000000040132",
                    "is_default": true
                },
                "phone": "22",
                "employee_id": null,
                "name": "Maverick",
                "id": "2000000040351",
                "is_vip_user": false,
                "department": null,
                "first_name": "Maverick",
                "job_title": null
            },
            "include_nonoperational_hours": true,
            "exchange_rate": "1",
            "end_time": {
                "display_value": "Apr 24, 2025 09:15 AM",
                "value": "1745466355256"
            },
            "description": "Added worklog",
            "other_charge": {
                "display_value": "12.00",
                "currency_symbol": "$",
                "value": 12,
                "secondary_currency": {
                    "display_value": "12.00",
                    "currency_symbol": "$",
                    "value": 12
                }
            },
            "total_charge": {
                "display_value": "132.00",
                "currency_symbol": "$",
                "value": 132,
                "secondary_currency": {
                    "display_value": "132.00",
                    "currency_symbol": "$",
                    "value": 132
                }
            },
            "created_by": {
                "email_id": "test@zoho.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": "1234567890",
                "last_name": null,
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "10",
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "2000000040132",
                    "is_default": true
                },
                "phone": "22",
                "employee_id": null,
                "name": "Maverick",
                "id": "2000000040351",
                "is_vip_user": false,
                "department": null,
                "first_name": "Maverick",
                "job_title": null
            },
            "recorded_time": {
                "display_value": "Apr 24, 2025 09:16 AM",
                "value": "1745466374289"
            },
            "time_spent": {
                "hours": "12",
                "minutes": "0",
                "value": "43200000"
            },
            "tech_charge": {
                "display_value": "120.00",
                "currency_symbol": "$",
                "value": 120,
                "secondary_currency": {
                    "display_value": "120.00",
                    "currency_symbol": "$",
                    "value": 120
                }
            },
            "start_time": {
                "display_value": "Apr 23, 2025 09:15 PM",
                "value": "1745423155256"
            },
            "worklog_type": null,
            "currency": {
                "symbol": "$",
                "code": "USD",
                "deleted": false,
                "exchange_rate": "1",
                "name": "US Dollar",
                "id": "2000000004427"
            },
            "id": "200000005987"
        }
    ]
}

删除请求工作日志

此操作帮助您删除请求工作日志。

Url

<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response

Python

#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/requests/{request_id}/worklogs/{worklog_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}