创建岗位

POST /v1/positions

请求参数
参数 类型 必填 说明
parent 对象 是 父级岗位.
parent.id 整型 是 父级岗位ID.
name 字符串 是 名称.
remark 字符串 否 备注.
响应数据
属性名 类型 说明
code 整型 响应编码.
message 字符串 响应消息.
visible 布尔型 是否可见, true / false .
data 对象 业务对象.
data.id 整型 岗位ID.
data.parent 对象 父级岗位.
data.parent.id 整型 父级岗位ID.
data.name 字符串 名称.
data.remark 字符串 备注.
请求示例
$ curl 'https://servicego.udesk.cn/api/v1/positions?email=admin@udesk.cn&timestamp=1496631984&sign=ef506d04ef74e1031f91025494244e88f3559b78' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "parent" : {
    "id" : 2
  },
  "name" : "测试岗位1",
  "remark" : "测试用"
}'
响应示例
{
  "code" : 200,
  "message" : "OK",
  "visible" : false,
  "data" : {
    "id" : 2,
    "parent" : {
      "id" : 2
    },
    "name" : "测试岗位1",
    "remark" : "测试用"
  }
}

更新岗位

PUT /v1/positions/{id:^[1-9]\d*$}

嵌入请求参数
参数 类型 必填 说明 限制
id 整型 是 岗位ID 必须大于1, ^[1-9]\d*$
请求参数
参数 类型 必填 说明
parent 对象 否 父级岗位.
parent.id 整型 否 父级岗位ID.
name 字符串 否 名称.
remark 字符串 否 备注.
响应数据
属性名 类型 说明
code 整型 响应编码.
message 字符串 响应消息.
visible 布尔型 是否可见, true / false .
请求示例
$ curl 'https://servicego.udesk.cn/api/v1/positions/2?email=admin@udesk.cn&timestamp=1496631984&sign=ef506d04ef74e1031f91025494244e88f3559b78' -i -X PUT -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "parent" : {
    "id" : 2
  },
  "name" : "测试岗位2",
  "remark" : "测试2"
}'
响应示例
{
  "code" : 200,
  "message" : "OK",
  "visible" : false
}

查询岗位

GET /v1/positions/{id:^[1-9]\d*$}

嵌入请求参数
参数 类型 必填 说明 限制
id 整型 是 岗位ID 必须大于1, ^[1-9]\d*$
响应数据
属性名 类型 说明
code 整型 响应编码.
message 字符串 响应消息.
visible 布尔型 是否可见, true / false .
data 对象 业务对象.
data.id 整型 岗位ID.
data.parent 对象 父级岗位.
data.parent.id 整型 父级岗位ID.
data.name 字符串 名称.
data.remark 字符串 备注.
请求示例
$ curl 'https://servicego.udesk.cn/api/v1/positions/2?email=admin@udesk.cn&timestamp=1496631984&sign=ef506d04ef74e1031f91025494244e88f3559b78' -i -H 'Content-Type: application/json' -H 'Accept: application/json'
响应示例
{
  "code" : 200,
  "message" : "OK",
  "visible" : false,
  "data" : {
    "id" : 2,
    "parent" : {
      "id" : 2
    },
    "name" : "测试岗位2",
    "remark" : "测试2"
  }
}

删除岗位

DELETE /v1/positions/{id:^[1-9]\d*$}

嵌入请求参数
参数 类型 必填 说明 限制
id 整型 是 岗位ID 必须大于1, ^[1-9]\d*$
响应数据
属性名 类型 说明
code 整型 响应编码.
message 字符串 响应消息.
visible 布尔型 是否可见. true / false .
请求示例
$ curl 'https://servicego.udesk.cn/api/v1/positions/3?email=admin@udesk.cn&timestamp=1496631984&sign=ef506d04ef74e1031f91025494244e88f3559b78' -i -X DELETE -H 'Content-Type: application/json' -H 'Accept: application/json'
响应示例
{
  "code" : 200,
  "message" : "OK",
  "visible" : false
}

查询岗位列表

GET /v1/positions

响应数据
属性名 类型 说明
code 整型 响应编码.
message 字符串 响应消息.
visible 布尔型 是否可见, true / false .
data 数组 业务对象.
data[].id 整型 岗位ID.
data[].parent 对象 父级岗位.
data[].parent.id 整型 父级岗位ID.
data[].name 字符串 名称.
data[].remark 字符串 备注.
请求示例
$ curl 'https://servicego.udesk.cn/api/v1/positions?email=admin@udesk.cn&timestamp=1496631984&sign=ef506d04ef74e1031f91025494244e88f3559b78' -i -H 'Content-Type: application/json' -H 'Accept: application/json'
响应示例
{
  "code" : 200,
  "message" : "OK",
  "visible" : false,
  "data" : [ {
    "id" : 2,
    "parent" : {
      "id" : 2
    },
    "name" : "测试岗位2",
    "remark" : "测试2"
  }]
}