[关闭]
@fuyb1986 2016-05-13T08:42:37.000000Z 字数 1969 阅读 571

获取达人列表的接口

好热闹


共有 get_, search_, get_followed_ 三个接口,
这些接口返回的数据是相同的。

获取所有达人


这个接口有 10 分钟缓存

Description

可以根据分类获取达人,分页返回每页 10 个。

Method and URL Structure

Method Resource URL
GET /cmd/?cmd=get_expert_infos

Request Parameters

Name Description Required Default
page 分页页码 No 1
category_name 分类的名称 No

Request

  1. {
  2. "page":1
  3. "category_name":u"分类",
  4. }

cURL Example

  1. curl http://localhost/cmd/?cmd=/cmd/?cmd=get_expert_info_skills&expert=10987654321&username=12345678910&password=123456

JSON Response

达人的用户信息

Name Description
username 达人的用户名
nickname 用户昵称
user_desc 用户简介
is_public_number 是否公众号
thumb 用户头像

skills: 达人的技能集合

Name Description
skill_id 技能 ID
skill 技能名称
price 技能价格
categroy 技能分类
name 技能分类的名称
id 技能分类的 ID
skill_type 技能类型

expert_info: 达人信息

Name Description
sex 性别
slogan slogan
thumb 达人大图
short_desc 达人简介
order_count 订单总数
is_new 是否新申请达人
order_count 订单总数
done_order_count 完成回答的订单数
order_statistics 回答率
  1. [{
  2. "username": "12345678910",
  3. "nickname": "昵称",
  4. "user_desc": "",
  5. "thumb":"http://resource.haorenao.cn/static/tea/threadimages/thumb.png",
  6. "is_public_number": false,
  7. "skills": [{
  8. "skill": "技能名称",
  9. "skill_id": 100,
  10. "price": 2.0,
  11. "category": {"name": "分类", "id": 1}
  12. }, ...
  13. "expert_info": {
  14. "sex": "男/女",
  15. "slogan": "SLOGAN",
  16. "thumb": "http://resource.haorenao.cn/static/tea/threadimages/thumb.jpg",
  17. "short_desc": ".....",
  18. "is_new": false,
  19. "order_count": 0,
  20. "done_order_count": 0,
  21. "order_statistics": 0,
  22. },
  23. },...]

搜索达人

Description

根据关键字获取达人信息,分页返回每页 10 个。

Method and URL Structure

Method Resource URL
GET /cmd/?cmd=search_expert_infos

Request Parameters

Name Description Required Default
page 分页页码 No 1
lookup_str 关键字 YES

Request

  1. {
  2. "page":1
  3. "lookup_str":u"关键字"
  4. }

cURL Example

  1. curl http://localhost/cmd/?cmd=get_expert_infos&page=1&category_name=茶叶

JSON Response

与获取达人信息的接口相同

获取用户 Follow 的达人

获取用户 Follow 的达人,分页返回每页 5 个。


这个接口有 5 分钟缓存

Method and URL Structure

Method Resource URL
GET /cmd/?cmd=get_followed_experts

Request Parameters

Name Description Required Default
page 分页页码 No 1
username 用户名 YES
password 密码 YES

Request

  1. {
  2. "page":1
  3. "username":"username",
  4. "password":"password",
  5. }

cURL Example

  1. curl http://www.haorenao.cn/cmd/?cmd=get_followed_experts&username=12345678910&password=123456&page=1

JSON Response

与获取达人信息的接口相同

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注