根据时间窗分页查询变动的职务序列变动信息

POST

/TenantBasePublicApiV2/v2/jobsequence/timewindow/search

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：查询一段时间范围内的变动的职务序列相关信息

警告信息：1.查询时间范围不宜过大，推荐不超过90天，否则容易引发超时现象。如需查询过大时间范围，请划分多次查询
2.由于历史原因，强烈建议页码小于等于100，否则容易引发超时现象
3.该接口支持元数据字段入参、出参控制

tips：1.默认查询：WithDisabled默认false不包含停用、WithDeleted默认false不包含删除
2.默认排序条件：无

错误码示例

417 Argument Error:StartTime>=StopTime（开始时间不能大于等于结束时间）

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBasePublicApiV2/v2/jobsequence/timewindow/search' \
--header 'Content-Type: application/json' \
--data-raw '{
    "StartTime": "2021-01-01",
    "StopTime": "2021-01-31",
    "WithDisabled": false,
    "WithDeleted": false,
    "PageIndex": 1,
    "PageSize": 300,
    "Columns": [
        "Name",
        "OId",
        "POId",
        "OIdResourceSet",
        "JobLevelType",
        "Level",
        "EstablishDate",
        "StartDate",
        "StopDate",
        "Status",
        "Order"
    ]
}'

响应示例

null

请求参数

Body 参数application/json

StartTime

string <date-time>

必需

时间范围开始时间，示例：2021-01-01T00:00:00。默认为调用接口当天的前一天00:00:00

StopTime

string <date-time>

必需

时间范围结束时间，示例：2021-01-01T23:59:59。默认为调用接口当天的00:00:00

WithDisabled

boolean

可选

是否包含停用/离职的记录，示例：false。默认不包含

WithDeleted

boolean

可选

是否包含删除的记录，示例：false。默认不包含

ExtQueries

array [object {5}]

可选

自定义字段查询条件，多个条件使用and且关系，不支持or或关系。

FieldName

string

可选

字段名称，示例：extExtQueryFloat_127666_832132060，严格区分大小写

QueryType

enum<string>

可选

条件类型：1大于、2大于等于、3小于、4小于等于、5等于、6不等于、7区间。仅日期时间或者数值类型支持大小比较、区间查询
Larger:
LargerOrEqual:
Smaller:
SmallerOrEqual:
Equal:
NotEqual:
Between:

枚举值:

LargerLargerOrEqualSmallerSmallerOrEqualEqualNotEqualBetween

Values

array[string]

可选

值列表，至少包含一个元素。若条件类型为1大于、2大于等于、3小于、4小于等于时，则只能包含一个值。若条件类型为7区间，则只能包含两个值。若为等于或者不等于，可最大支持300个值，且可使用null或者空字符串进行非空或空判断。

IncludeLowerValue

boolean

可选

是否包含最小值，仅用于区间查询，默认是

IncludeUpperValue

boolean

可选

是否包含最大值，仅用于区间查询，默认是

PageIndex

integer <int32>

必需

页码，示例：1。默认为1，强烈建议页码小于等于100

PageSize

integer <int32>

必需

每页数量，示例：100。默认为300,最大为300

Sort

object

可选

排序字段，示例：按创建时间正序{"CreatedTime":1}。非必填，1-正序，2-倒序

额外字段

integer <int32>

可选

Columns

array[string]

必需

需要获取的字段编码集合，必填，示例：["Name"]
查询可用列

示例

返回响应

🟢200OK

application/json

Body

No schema defined

修改于 2021-10-13 10:54:25

根据职务序列OId集合获取未删除的职务序列相关信息

部分更新职位

根据时间窗分页查询变动的职务序列变动信息

错误码示例#

请求参数

返回响应

错误码示例