用户

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

获取手机验证码

获取手机验证码

POST https://rate.trantordata.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

200 成功获取手机验证码

401: Unauthorized Permission denied

400: Bad Request 阿里短信服务所提供的错误，具体详见返回message。如：手机号参数错误

429: Too Many Requests 短时间内多次请求验证码

406: Not Acceptable 收费API用户请求此接口时

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

登录或注册新用户

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

POST https://rate.trantordata.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	手机验证码

200: OK 登录或注册成功

登录/注册成功后会设置相应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
}

410: Gone 验证码已过期

401: Unauthorized Permission denied

403: Forbidden 验证码错误

406: Not Acceptable 收费API用户请求此接口时

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

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

提交审核

POST https://rate.trantordata.com/open_v1/user/submit_review

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

X-JYY-UserId和X-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	用户名

200: OK 提交成功

{
	// 用户唯一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,
}

401: Unauthorized Permission denied

400: Bad Request entity_name 或 position 为空字符串时；nickname长度大于200时

409: Conflict 当用户已删除 或 已审核通过时

403: Forbidden 匿名请求时

406: Not Acceptable 收费API用户请求此接口时

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