接口文档 - my1free/wx-nankai-job GitHub Wiki

求职者首页接口

注：接口返回均为json字符串。code为0表示成功，非0表示失败。

uri: /job/list

描述

工作列表，下图红框部分

image.png

request

可选参数 描述 值
maxId 分页获取job list时，需要一个最大的job id来限制范围 Integer类型。初始可以为null，上拉获取时，maxId需要是上次获取结果最后一条job的id
limit 每次获取多少条。默认为10 Integer，可以为null
cityId 限定城市 Integer, city id不是国家通用的城市编码，是由服务返回的自定义id
companyId 限定公司 Integer, company id也是由服务返回的
companyIds 限定多个公司 String，多个company id通过逗号分隔
categoryId 限定类型，如“技术”、“产品” Integer

response

返回json字符串。code为0表示成功，非0表示失败。

data中是job list。

{
	"msg":"success",
	"code":0,
	"data":[
		{
			"categoryId":1,
			"cityId":1,
			"cityName":"北京",
			"companyId":1,
			"companyLogo":"https://file.digitaling.com/eImg/logo/20171209/20171209024530_42866_320.png",
			"companyName":"美团网",
			"education":"本科",
			"expirence":"1-5",
			"id":18,
			"jobAbstract":"{\"education\":\"本科\",\"expirence\":\"1-5\"}",
			"salaryHigh":40,
			"salaryLow":25,
			"status":1,
			"title":"Java工程师"
		},
		{
			"categoryId":1,
			"cityId":1,
			"cityName":"北京",
			"companyId":1,
			"companyLogo":"https://file.digitaling.com/eImg/logo/20171209/20171209024530_42866_320.png",
			"companyName":"美团网",
			"education":"本科",
			"expirence":"1-5",
			"id":17,
			"jobAbstract":"{\"education\":\"本科\",\"expirence\":\"1-5\"}",
			"salaryHigh":40,
			"salaryLow":25,
			"status":1,
			"title":"中高级Java开发工程师"
		}
	]
}

uri: /integrated/navi

描述 首页的导航栏，包含城市列表和工作分类Tab。如下图红框所示：

image.png

request

无

response

返回json字符串。code为0表示成功，非0表示失败。

categories表示工作分类

cities表示所支持的城市列表

{
	"msg":"success",
	"code":0,
	"data":{
		"categories":[
			{
				"ctime":1525647892,
				"id":1,
				"name":"技术",
				"utime":1525647892
			},
			{
				"ctime":1525647892,
				"id":2,
				"name":"产品",
				"utime":1525647892
			}
		],
		"cities":[
			{
				"ctime":1525576285,
				"id":1,
				"name":"北京",
				"utime":1525576285
			},
			{
				"ctime":1525590920,
				"id":2,
				"name":"上海",
				"utime":1525590920
			}
		]
	}
}

工作详情页接口

uri: /job/detail

描述

选定工作的详情，如下图红框部分所示：

image.png

request

可选参数 描述 值
jobId 选定job的id Integer类型。必填值

response

{
	"msg":"success",
	"code":0,
	"data":{
		"categoryId":1,
		"cityId":1,
		"cityName":"北京",
		"companyId":1,
		"companyLogo":"https://file.digitaling.com/eImg/logo/20171209/20171209024530_42866_320.png",
		"companyName":"美团网",
		"education":"本科",
		"expirence":"1-5",
		"id":16,
		"jobAbstract":"{\"education\":\"本科\",\"expirence\":\"1-5\"}",
		"salaryHigh":40,
		"salaryLow":25,
		"status":1,
		"title":"高级Java开发工程师"
	}
}

uri: /user/collection/confirm

描述

收藏某个工作，如下图红框所示：

image.png

request

可选参数 描述 值
jobId 选定job的id Integer类型。必填值
xxx 标识用户的id String类型。必填值

response

待定。。。

uri: /user/collection/cancel

描述

取消之前收藏的工作

request

可选参数 描述 值
jobId 选定job的id Integer类型。必填值
xxx 标识用户的id String类型。必填值

response

待定。。。

搜索页接口

uri: /job/search

描述

按条件搜索工作，下图红框部分:

image.png

request

可选参数 描述 值
maxId 分页获取job list时，需要一个最大的job id来限制范围 Integer类型。初始可以为null，上拉获取时，maxId需要是上次获取结果最后一条job的id
limit 每次获取多少条。默认为10 Integer，可以为null
cityId 限定城市 Integer, city id不是国家通用的城市编码，是由服务返回的自定义id
keyword 关键词 String类型。必填值

response

同/job/list

公司详情接口

uri: /company/detail

描述

展示公司的详情

request

可选参数 描述 值
companyId 公司id Integer类型。比填值

response

uri: /user/concerned/confirm

描述

关注某个公司

request

可选参数 描述 值
companyId 选定company的id Integer类型。必填值
xxx 标识用户的id String类型。必填值

response

{
	"msg":"success",
	"code":0,
	"data":null
}

uri: /user/concerned/cancel

描述

取消关注某个公司

request

可选参数 描述 值
companyId 选定company的id Integer类型。必填值
xxx 标识用户的id String类型。必填值

response

{
	"msg":"success",
	"code":0,
	"data":null
}

个人首页接口

/user/login

描述

用户登录

request

response

/user/update

描述

request

response

关注的公司接口

uri: /user/concerned/list

描述

关注的公司列表。按时间倒序排列。分页展示

request

可选参数 描述 值
maxId 分页获取company list时，需要一个最大的company id来限制范围 Integer类型。初始可以为null，上拉获取时，maxId需要是上次获取结果最后一条company的id
limit 每次获取多少条。默认为10 Integer，可以为null
sessionId 标识用户的id String类型。必填值

response

{
	"msg":"success",
	"code":0,
	"data":[
		{
			"concerned":false,
			"logo":"https://file.digitaling.com/eImg/logo/20171209/20171209024530_42866_320.png",
			"name":"美团网"
		}
	]
}

uri: /user/concerned/job/list

描述

关注的公司所有职位信息。按时间倒序排列。分页展示

request

|maxId|分页获取job list时，需要一个最大的job id来限制范围|Integer类型。初始可以为null，上拉获取时，maxId需要是上次获取结果最后一条job的id| |limit|每次获取多少条。默认为10|Integer，可以为null| |sessionId|标识用户的id|String类型。必填值|

response

{
	"msg":"success",
	"code":0,
	"data":[
		{
			"categoryId":1,
			"cityId":1,
			"cityName":"北京",
			"companyId":1,
			"companyLogo":"https://file.digitaling.com/eImg/logo/20171209/20171209024530_42866_320.png",
			"companyName":"美团网",
			"education":"本科",
			"expirence":"1-5",
			"id":18,
			"jobAbstract":"{\"education\":\"本科\",\"expirence\":\"1-5\"}",
			"salaryHigh":40,
			"salaryLow":25,
			"status":1,
			"title":"Java工程师"
		}
	]
}

收藏的职位接口

uri: /user/collection/list

描述 收藏的职位列表。按时间倒序排列。分页展示

request

可选参数 描述 值
maxId 分页获取job list时，需要一个最大的job id来限制范围 Integer类型。初始可以为null，上拉获取时，maxId需要是上次获取结果最后一条job的id
limit 每次获取多少条。默认为10 Integer，可以为null
xxx 标识用户的id String类型。必填值

response

同/job/list

投递的职位接口

uri: /user/delivery/list

描述 投递的职位列表。按时间倒序排列。分页展示

request

可选参数 描述 值
maxId 分页获取job list时，需要一个最大的job id来限制范围 Integer类型。初始可以为null，上拉获取时，maxId需要是上次获取结果最后一条job的id
limit 每次获取多少条。默认为10 Integer，可以为null
xxx 标识用户的id String类型。必填值

response 同/job/list