共用數據存放一些共用的接口說明 [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" } ] } ~~~