用户

收费API 无需使用,若调用,会返回错误码406

获取手机验证码

获取手机验证码

POST https://jianyiyun.com/open_v1/send/phone/code

Headers

Name
Type
Description

Content-Type*

String

application/x-www-form-urlencoded

Api-Key*

String

sk-xkze4N8V...lyUTKY93

Request Body

Name
Type
Description

phone*

String

手机号。

支持国际/国内手机号。

国际手机号前必须添加国家代码,如+1

该手机验证码有效期为15分钟。

登录或注册新用户

登录或注册新用户,登录注册一体,需使用手机验证码

POST https://jianyiyun.com/open_v1/register_or_login

Headers

Name
Type
Description

Content-Type*

String

application/x-www-form-urlencoded

Api-Key*

String

sk-xkze4N8V...lyUTKY93

Request Body

Name
Type
Description

phone*

String

用于登录的手机号。

支持国际/国内手机号。

国际手机号前必须添加国家代码,如+1

code*

String

手机验证码

登录/注册成功后会设置相应Cookie

{
        "user": {
		// 用户唯一id
		"id": "200304140833djpl3nDc",
		// 用户创建时间,UTC时间戳
		"addedAt": 1583330914000,
		// 用户上次更新时间,UTC时间戳
		"lastUpdatedAt": 1684740681010,
		// 用户名
		"nickName": "Wesley",
		// 用户头像,若存在,是一个合法的URL,若不存在,为NULL
		"avatarUrl": null,
		// 用户状态,enum值,详情见 UserStatus 枚举
		"status": "Registered",
		// 用户手机号
		"phone": "13122928101",
		// 用户所在公司
		"company": null,
		// 用户公司职位
		"position": null,
		// 用户邮箱
		"email": null,
	},
	// 用户security hash,用于API请求时辨别用户
	// 若某API需要用户信息,则必须在Cookie中添加
	//     X-JYY-UserId=200...nDc
	//     X-JYY-SecurityHash=dal...3jk
	"securityHash": "dalfd9123jk",
	// 登录或注册行为,true则代表登录,false代表注册
	"isLogin": true
}

用户提交公司信息进行审核

用户未进行审核前,仅能查价10次,补充公司信息并通过审核后,才能继续查询价格

提交审核

POST https://jianyiyun.com/open_v1/user/submit_review

这个接口需要登录者信息,即Cookie内需增加X-JYY-UserIdX-JYY-SecurityHash,否则视为匿名请求,无权限。

X-JYY-UserIdX-JYY-SecurityHash字段在登录时已提供。

Headers

Name
Type
Description

Content-Type*

String

application/x-www-form-urlencoded

Api-Key*

String

sk-xkze4N8V...lyUTKY93

Cookies

Name
Type
Description

X-JYY-UserId*

String

200...nDc

X-JYY-SecurityHash*

String

dal...3jk

Request Body

Name
Type
Description

entity_name*

String

公司名称

position*

String

用户所在公司的职位

nickname

String

用户名

{
	// 用户唯一id
	"id": "200304140833djpl3nDc",
	// 用户创建时间,UTC时间戳
	"addedAt": 1583330914000,
	// 用户上次更新时间,UTC时间戳
	"lastUpdatedAt": 1684740681010,
	// 用户名
	"nickName": "Wesley",
	// 用户头像,若存在,是一个合法的URL,若不存在,为NULL
	"avatarUrl": null,
	// 用户状态,enum值,详情见 UserStatus 枚举
	"status": "PendingAdminReview",
	// 用户手机号
	"phone": "13122928101",
	// 用户所在公司
	"company": "上海测试有限公司",
	// 用户公司职位
	"position": "开发工程师",
	// 用户邮箱
	"email": null,
}

建议注册后,直接调用提交公司信息进行审核的API,这样用户一般不会触发10次查价的限制

最后更新于