共用数据存放一些共用的接口说明 [TOC=2] ## 枚举变量 ### 频率说明(frequency): | 枚举变量 | 说明 | | --- | --- | | once | 仅一次 | | each | 每次 | | day | 每天 | >[info] 上限说明，若上限为 0 表示没有上限 >雇主端暂不涉及到积分，积分全部设置为 0 ## 获取相关配置项 ~~~[api] get:/ip地址/webapp/systemConfig <<< success { "code": 0, "data": { "employer_recruit_fee": 500, "points_max_deduction": 1000,//积分最多抵扣 "balance_max_deduction": 1000,//红包最多抵扣 "invite_new_user_reward": 500,// "invite_new_user_reward_threshold": 5,//邀请好友人数 "invited_user_reward": 500, "employer_rate_discount": [//雇主评价享受折扣 { "rate": 40,//分值 "discount": 120//对应折扣 }, { "rate": 50, "discount": 110 }, { "rate": 60, "discount": 100 }, { "rate": 80, "discount": 0 }, { "rate": 100, "discount": 0 } ], "employer_online_order_reward_points": 50, "employer_rate_reward_points": 50, "labour_free_vip_days": 15, "labour_real_name_reward": 500, "labour_vip_card_fee": { "30": 3000, "90": 8800, "180": 16600, "365": 26900 }, "labour_rate_vip_fee_discount": [ { "rate": 60, "discount": 120 }, { "rate": 80, "discount": 100 }, { "rate": 100, "discount": 90 } ], "labour_point_plus": [//民工积分获得规则 { "name": "通过实名认证",//标题 "score": 50,//分值 "capped": 50,//上限 "frequency": "once",//频率 见枚举变量 "description": "authentication"//描述 }, { "name": "参与抢单", "score": 10, "capped": 0, "frequency": "each", "description": "grab_a_single" }, { "name": "抢单成功", "score": 20, "capped": 0, "frequency": "each", "description": "grab_a_single_success" }, { "name": "接受预约", "score": 30, "capped": 0, "frequency": "each", "description": "accept_appointment" }, { "name": "推广自己", "score": 20, "capped": 50, "frequency": "day", "description": "promote_their" }, { "name": "完成报价", "score": 50, "capped": 50, "frequency": "once", "description": "complete_the_quotation" }, { "name": "收到好评", "score": 20, "capped": 0, "frequency": "each", "description": "received_high_praise" } ], "labour_point_less": [//民工积分扣除规则 { "name": "拒绝预约", "score": -100, "capped": 0, "frequency": "each", "description": "refuse_reservation" }, { "name": "取消订单", "score": -100, "capped": 0, "frequency": "each", "description": "cancel_order" }, { "name": "恶意差评", "score": -200, "capped": 0, "frequency": "each", "description": "bad_review" }, { "name": "逃工爽约", "score": -100, "capped": 0, "frequency": "each", "description": "escape" } ], "employer_point_plus": [//雇主积分获得规则 { "name": "完善资料", "score": 0, "capped": 20, "frequency": "once", "description": "complete_material" }, { "name": "分享好友", "score": 0, "capped": 50, "frequency": "day", "description": "share_to_friends" }, { "name": "分享朋友圈", "score": 0, "capped": 50, "frequency": "day", "description": "share_to_friends_circle" }, { "name": "完成评价", "score": 0, "capped": 0, "frequency": "each", "description": "evaluation" }, { "name": "招工成功", "score": 0, "capped": 0, "frequency": "each", "description": "job_success" } ], "employer_point_less": [//雇主积分扣除规则 { "name": "取消订单", "score": 0, "capped": 0, "type": "each", "description": "cancel_order" }, { "name": "超时取消订单", "score": 0, "capped": 0, "type": "each", "description": "time_out_cancel_order" }, { "name": "恶意差评", "score": 0, "capped": 0, "type": "each", "description": "bad_review" } ], "permission_device_read": 1,//可读设备权限 "permission_device_control": 2,//可以控制设备权限 "permission_device_grant": 4//设备授权给其他用户 } } ~~~ ## 获取区域 >[info] 传参数值，不传表示获取所有的区域。要获取下一级，就传查询出来的id的值 > parent_id 暂时没有使用，值为 null 表示最高的级别 ~~~[api] get:/ip地址/webapp/getRegions *int:parent_id=null#区域id <<< success { "code": 0, "data": [ { "id": 1, "name": "山东省",//省名 "parent_id": null//上一级id } ] } ~~~ ## 获取排序后的区域 ~~~[api] get:/ip地址/webapp/getRegionsSort *int:parent_id=null#区域id <<< success { "code": 0, "data": [ "B": [ { "id": 11, "name": "北关村", "parent_id": 5, "initials": "B" }, { "id": 45, "name": "北郭村", "parent_id": 5, "initials": "B" } ] } ~~~ ## 批量获取区域 ~~~[api] get:/ip地址/webapp/getRegionsAll *json:list=[1,2]#区域id <<< success { "code": 0, "data": [ { "id": 1, "name": "山东省",//省名 "parent_id": null//上一级id } ] } ~~~ ## 搜索区域 ~~~[api] get:/ip地址/webapp/getRegionsSearch *int:parent_id=null#区域id *string:name=""#搜索的地区名称 <<< success { "code": 0, "data": [ "B": [ { "id": 11, "name": "北关村", "parent_id": 5, "initials": "B" }, { "id": 45, "name": "北郭村", "parent_id": 5, "initials": "B" } ] } ~~~