| | 1668 | === 4.7收到的回复(帖子、动态) === |
| | 1669 | {{{ |
| | 1670 | 说明:收到的回复(帖子、动态) |
| | 1671 | |
| | 1672 | 请求参数: |
| | 1673 | 登陆信息通过session拿 |
| | 1674 | |
| | 1675 | 是否登录:是 |
| | 1676 | 缓存时间:无 |
| | 1677 | 是否分页:有 |
| | 1678 | |
| | 1679 | 返回 |
| | 1680 | "data": [ |
| | 1681 | { |
| | 1682 | “replyType”:类型,0帖子 1动态 |
| | 1683 | “targetId”:点击进入详情用的id |
| | 1684 | “replyId”:回复id, |
| | 1685 | “replyContent”: |
| | 1686 | “replyUserId”: |
| | 1687 | “replyUserName”: |
| | 1688 | “replyUserImg”: |
| | 1689 | “toReplyId”:被回复id |
| | 1690 | “toReplyContent”: |
| | 1691 | “time”: |
| | 1692 | }, |
| | 1693 | { |
| | 1694 | “replyType”:类型,0帖子 1动态 |
| | 1695 | “targetId”:点击进入详情用的id |
| | 1696 | “replyId”:回复id, |
| | 1697 | “replyContent”: |
| | 1698 | “replyUserId”: |
| | 1699 | “replyUserName”: |
| | 1700 | “replyUserImg”: |
| | 1701 | “toReplyId”:被回复id |
| | 1702 | “toReplyContent”: |
| | 1703 | “time”: |
| | 1704 | }, |
| | 1705 | ] |
| | 1706 | 帖子回复和动态回复要求对应返回字段一致 |
| | 1707 | }}} |
| | 1708 | === 5.1兑换列表 === |
| | 1709 | {{{ |
| | 1710 | 接口:/gift/listGift4App.do |
| | 1711 | 说明:用于app兑换列表显示 |
| | 1712 | 请求参数: |
| | 1713 | |
| | 1714 | 是否登录:否 |
| | 1715 | 缓存时间:无 |
| | 1716 | 是否分页:是 |
| | 1717 | |
| | 1718 | 返回 |
| | 1719 | "data": [ |
| | 1720 | { |
| | 1721 | “id”:兑换礼品id//看后台设计是否有用 |
| | 1722 | “img”:图片url |
| | 1723 | “name”:礼品名称 |
| | 1724 | “cost”:兑换所需金币 |
| | 1725 | “status”://0-》马上兑换 1-》缺货 |
| | 1726 | }, |
| | 1727 | { |
| | 1728 | “id”:兑换礼品id//看后台设计是否有用 |
| | 1729 | “img”:图片url |
| | 1730 | “name”:礼品名称 |
| | 1731 | “cost”:兑换所需金币 |
| | 1732 | “status”://0-》马上兑换 1-》缺货 |
| | 1733 | } |
| | 1734 | ] |
| | 1735 | }}} |
| | 1736 | === 5.2用户兑换信息 === |
| | 1737 | {{{ |
| | 1738 | 接口:/gift/listConversionByUserId4App.do |
| | 1739 | 说明:用户金币、兑换信息返回 |
| | 1740 | |
| | 1741 | 请求参数: |
| | 1742 | 登陆信息从session拿,不需要传 |
| | 1743 | |
| | 1744 | 是否登录:是 |
| | 1745 | 缓存时间:无 |
| | 1746 | 是否分页:无 |
| | 1747 | |
| | 1748 | 返回 |
| | 1749 | "data": { |
| | 1750 | “userId”:用户id |
| | 1751 | “exchangeCount”:兑换记录总数 |
| | 1752 | “goldCount”:金币总数 |
| | 1753 | “userName”:用户昵称 |
| | 1754 | “userImg”:用户头像 |
| | 1755 | } |
| | 1756 | }}} |
| | 1757 | === 5.3申请兑换 === |
| | 1758 | {{{ |
| | 1759 | 接口:/gift/createReply4ConversionInfo.do |
| | 1760 | 说明:申请兑换提交信息 |
| | 1761 | |
| | 1762 | 请求方式:POST |
| | 1763 | 请求参数: |
| | 1764 | giftId:礼品Id |
| | 1765 | realName:真实姓名 |
| | 1766 | provinceId:省id |
| | 1767 | provinceName:省名字 |
| | 1768 | cityId:市id,无则不传 |
| | 1769 | cityName:市名字,无则不传 |
| | 1770 | address:地址 |
| | 1771 | postCode:邮编 |
| | 1772 | phoneNum:手机号码 |
| | 1773 | |
| | 1774 | 是否登录:是 |
| | 1775 | 缓存时间:无 |
| | 1776 | 是否分页:无 |
| | 1777 | |
| | 1778 | 返回 |
| | 1779 | }}} |
| | 1780 | === 5.4兑换记录 === |
| | 1781 | {{{ |
| | 1782 | 接口:/gift/listConversionHistoryByUserId4App.do |
| | 1783 | 说明:兑换记录列表 |
| | 1784 | |
| | 1785 | 请求参数: |
| | 1786 | session获取用户id |
| | 1787 | |
| | 1788 | 是否登录:是 |
| | 1789 | 缓存时间:无 |
| | 1790 | 是否分页:是 |
| | 1791 | |
| | 1792 | 返回 |
| | 1793 | "data": [ |
| | 1794 | { |
| | 1795 | “id”:兑换记录id |
| | 1796 | “img”:图片url |
| | 1797 | “name”:礼品名称 |
| | 1798 | “cost”:兑换所需金币 |
| | 1799 | “time”:兑换时间,返回时间戳 |
| | 1800 | “status”://0-》待发货 1-》已发货 -1-》驳回 2-》待付款 |
| | 1801 | }, |
| | 1802 | { |
| | 1803 | “id”:兑换记录id |
| | 1804 | “img”:图片url |
| | 1805 | “name”:礼品名称 |
| | 1806 | “cost”:兑换所需金币 |
| | 1807 | “time”:兑换时间,返回时间戳 |
| | 1808 | “status”://0-》待发货 1-》已发货 -1-》驳回 2-》待付款 |
| | 1809 | } |
| | 1810 | ] |
| | 1811 | }}} |
| | 1812 | === 6.1 附近的人 === |
| | 1813 | {{{ |
| | 1814 | 接口:/user/listUserByPosition.do |
| | 1815 | 说明:附近的人列表 |
| | 1816 | |
| | 1817 | 请求参数 |
| | 1818 | longitude 经度 |
| | 1819 | latitude 纬度 |
| | 1820 | |
| | 1821 | 是否登录:否 |
| | 1822 | 缓存时间:无 |
| | 1823 | 是否分页:是 |
| | 1824 | |
| | 1825 | 返回 |
| | 1826 | "data": [ |
| | 1827 | { |
| | 1828 | “userId”:用户id |
| | 1829 | “userName”:用户昵称 |
| | 1830 | “userImg”:用户头像 |
| | 1831 | “sex”:性别 |
| | 1832 | “distance”:距离 |
| | 1833 | “serialName”:认证车系 |
| | 1834 | }, |
| | 1835 | { |
| | 1836 | “userId”:用户id |
| | 1837 | “userName”:用户昵称 |
| | 1838 | “userImg”:用户头像 |
| | 1839 | “sex”:性别 |
| | 1840 | “distance”:距离 |
| | 1841 | “serialName”:认证车系 |
| | 1842 | }, |
| | 1843 | ] |
| | 1844 | }}} |
| | 1845 | === 6.2更新用户位置信息 === |
| | 1846 | {{{ |
| | 1847 | 说明:更新用户所在位置 |
| | 1848 | |
| | 1849 | 请求方法:POST |
| | 1850 | 请求参数 |
| | 1851 | longitude 经度 |
| | 1852 | latitude 纬度 |
| | 1853 | session拿userid信息 |
| | 1854 | }}} |
| | 1855 | === 7.1 任务列表 === |
| | 1856 | {{{ |
| | 1857 | 请求参数 |
| | 1858 | session拿用户参数 |
| | 1859 | |
| | 1860 | 是否登录:是 |
| | 1861 | 缓存时间:无 |
| | 1862 | 是否分页:否 |
| | 1863 | |
| | 1864 | 返回 |
| | 1865 | { |
| | 1866 | “disposableMission”:[ |
| | 1867 | { |
| | 1868 | “missionId”:任务id,或任务类型,每个任务一个 |
| | 1869 | “missionName”:”任务名称” |
| | 1870 | “missionIcon”:任务icon |
| | 1871 | “gold”:“加金币数” |
| | 1872 | “limitCount”:上限数//无则返回0 |
| | 1873 | “currentCount”:当前数//无则返回0,例如发了多少帖子 |
| | 1874 | “status”:有无领取奖励的状态, |
| | 1875 | “dis”:描述 |
| | 1876 | “action”:点击触发,如app内跳转pcautoclub://XXX或直接网址http://xxxx,参考焦点图action处理方式 |
| | 1877 | }//一次性任务 |
| | 1878 | “commonMission”:[ |
| | 1879 | { |
| | 1880 | “missionId”:任务id,或任务类型,每个任务一个 |
| | 1881 | “missionName”:”任务名称” |
| | 1882 | “missionIcon”:任务icon |
| | 1883 | “gold”:“加金币数” |
| | 1884 | “limitCount”:上限数//无则返回0 |
| | 1885 | “currentCount”:当前数//无则返回0,例如发了多少帖子 |
| | 1886 | “status”:有无领取奖励的状态 |
| | 1887 | “dis”:描述 |
| | 1888 | “action”:点击触发,如app内跳转pcautoclub://XXX或直接网址http://xxxx,参考焦点图action处理方式 |
| | 1889 | }//普通任务 |
| | 1890 | ] |
| | 1891 | } |
| | 1892 | }}} |
| | 1893 | |
| | 1894 | === 7.2领取奖励 === |
| | 1895 | {{{ |
| | 1896 | 说明:点击领取奖励 |
| | 1897 | |
| | 1898 | 请求方法:POST |
| | 1899 | 请求参数 |
| | 1900 | 任务missionId |
| | 1901 | session获取用户信息 |
| | 1902 | |
| | 1903 | 返回 |
| | 1904 | }}} |
| | 1905 | === 8.1 同城优惠列表 === |
| | 1906 | {{{ |
| | 1907 | 说明:获取同城优惠列表 |
| | 1908 | |
| | 1909 | 请求参数 |
| | 1910 | provinceId 发动态省地区id(必选) |
| | 1911 | cityId 发动态市地区id(无则不传) |
| | 1912 | |
| | 1913 | 是否登录:否 |
| | 1914 | 缓存时间:无 |
| | 1915 | 是否分页:是 |
| | 1916 | |
| | 1917 | 返回 |
| | 1918 | { |
| | 1919 | data:[ |
| | 1920 | { |
| | 1921 | “topicId”:帖子id |
| | 1922 | “img”:帖子图片 |
| | 1923 | “startTime”优惠开始时间 |
| | 1924 | “endTime”优惠结束时间 |
| | 1925 | “title”:帖子标题 |
| | 1926 | }, |
| | 1927 | { |
| | 1928 | “topicId”:帖子id |
| | 1929 | “img”:帖子图片 |
| | 1930 | “startTime”优惠开始时间 |
| | 1931 | “endTime”优惠结束时间 |
| | 1932 | “title”:帖子标题 |
| | 1933 | } |
| | 1934 | ] |
| | 1935 | } |
| | 1936 | }}} |
| | 1937 | |
| | 1938 | === 8.2同城首页信息 === |
| | 1939 | {{{ |
| | 1940 | 说明:同城首页信息,包括同城车友会(<3个),同城优惠(<5个) |
| | 1941 | 请求参数 |
| | 1942 | provinceId 发动态省地区id(必选) |
| | 1943 | cityId 发动态市地区id(无则不传) |
| | 1944 | |
| | 1945 | 是否登录:否 |
| | 1946 | 缓存时间:无 |
| | 1947 | 是否分页:否 |
| | 1948 | |
| | 1949 | 返回 |
| | 1950 | { |
| | 1951 | “sameCityClubCount”:同城车友会总数 |
| | 1952 | “sameCityPreferentialCount”:同城优惠总数 |
| | 1953 | “sameCityClubData”:[ |
| | 1954 | { |
| | 1955 | "logo": 车友会会标 |
| | 1956 | “clubBackgroundImg”://顶部背景图片url |
| | 1957 | “levelupTip”:升级提示,0-》不可升级,1-》可升级 |
| | 1958 | “applyCount”:待审核人数, |
| | 1959 | “presidentName”:会长昵称 |
| | 1960 | "announcement": 公告, |
| | 1961 | "memberSum": 成员数, |
| | 1962 | "cityName": 市, |
| | 1963 | "commentSum": 留言数, |
| | 1964 | "introduce": 简介, |
| | 1965 | "provinceName": 省, |
| | 1966 | "topicSum": 帖子数, |
| | 1967 | "totalPetrol": 总油值, |
| | 1968 | "clubId":用户ID, |
| | 1969 | "clubStatus":车友会状态(是否被锁之类) |
| | 1970 | "clubUrl":车友会域名, |
| | 1971 | "level": 等级ID, |
| | 1972 | "seriesName": 车系名称, |
| | 1973 | "brandName": 品牌名称, |
| | 1974 | "regionRank": 品牌排名, |
| | 1975 | "rank":全国排名, |
| | 1976 | "activitySum": 活动数, |
| | 1977 | "name":车友会名称, |
| | 1978 | "levelName": 等级名称, |
| | 1979 | "albumSum": 相册数, |
| | 1980 | "photoSum":照片数 |
| | 1981 | "activityName": 最新活动名称 |
| | 1982 | "memberId":会员ID,如果有 |
| | 1983 | "adminType":成员角色//说明参考2.2 |
| | 1984 | "isCheck":true/false 是否签到 |
| | 1985 | "forumId":论坛id,用于发帖 |
| | 1986 | } |
| | 1987 | ]//前三个 |
| | 1988 | “preferentialData”:[ |
| | 1989 | { |
| | 1990 | “topicId”:帖子id |
| | 1991 | “img”:帖子图片 |
| | 1992 | “time”帖子创建时间 |
| | 1993 | “title”:帖子标题 |
| | 1994 | } |
| | 1995 | ]//前5条 |
| | 1996 | } |
| | 1997 | }}} |
| | 1998 | |
| | 1999 | === 8.3同城动态 === |
| | 2000 | {{{ |
| | 2001 | 接口:/dyna/listLocalDyna.do |
| | 2002 | 说明:根据地区ID,返回车友动态列表 |
| | 2003 | 请求参数: |
| | 2004 | provinceId 发动态省地区id(必选) |
| | 2005 | cityId 发动态市地区id(无则不传) |
| | 2006 | 是否登录:否 |
| | 2007 | 缓存时间:无 |
| | 2008 | 是否分页:是 |
| | 2009 | |
| | 2010 | 返回结果: |
| | 2011 | { |
| | 2012 | "data": [ |
| | 2013 | { |
| | 2014 | "postCount":回复数 |
| | 2015 | "pubTime": 发布时间, |
| | 2016 | "authorId": 作者ID, |
| | 2017 | "forumId": 16160, |
| | 2018 | "authorName": 作者名称, |
| | 2019 | "nickname":作者昵称, |
| | 2020 | "contribution": 贡献油值, |
| | 2021 | "dynaInfoId",动态ID |
| | 2022 | "authorPhoto": 作者头像, |
| | 2023 | "isRecommend": 是否是推荐, |
| | 2024 | “content”:动态内容 |
| | 2025 | "images":[ |
| | 2026 | { |
| | 2027 | “url”:http://xxxx.jpg, |
| | 2028 | //真实宽度 |
| | 2029 | “width”:960, |
| | 2030 | //真实高度 |
| | 2031 | “height”:1000, |
| | 2032 | //质量参数,默认为0,10月上线 |
| | 2033 | "qua":80 |
| | 2034 | }, |
| | 2035 | { |
| | 2036 | “url”:http://xxxx.jpg, |
| | 2037 | //真实宽度 |
| | 2038 | “width”:960, |
| | 2039 | //真实高度 |
| | 2040 | “height”:1000, |
| | 2041 | //质量参数,默认为0,10月上线 |
| | 2042 | "qua":80 |
| | 2043 | } |
| | 2044 | ] |
| | 2045 | } |
| | 2046 | ] |
| | 2047 | } |
| | 2048 | }}} |
| | 2049 | |
| | 2050 | === 8.4我的二维码 === |
| | 2051 | {{{ |
| | 2052 | 接口:/util/userQrCode.jsp |
| | 2053 | 我的二维码(参考车友会二维码) |
| | 2054 | 扫描结果 |
| | 2055 | http://用户主页?action=pcautoclub://user-center/用户id |
| | 2056 | }}} |
| | 2057 | |
| | 2058 | === 8.5经纬度获取城市 === |
| | 2059 | {{{ |
| | 2060 | 接口:http://whois.pconline.com.cn/ipAreaCoordJson.jsp?coords=113.360414,23.16405&level=3&json=true |
| | 2061 | 说明:根据经纬度获取城市 |
| | 2062 | |
| | 2063 | 请求参数 |
| | 2064 | longitude 经度 |
| | 2065 | latitude 纬度 |
| | 2066 | |
| | 2067 | 返回 |
| | 2068 | { |
| | 2069 | areaCode:省id |
| | 2070 | areaName:省名字 |
| | 2071 | cityCode:城市ID//如无城市,则id为0 |
| | 2072 | cityName:城市名字//无则为空字符串 |
| | 2073 | } |
| | 2074 | }}} |
| | 2075 | |
| | 2076 | === 8.6论坛首页 === |
| | 2077 | {{{ |
| | 2078 | 说明:论坛首页-猜你喜欢(客户端4.5新增接口,由于车友会现实样式不同,需要增加thumbImg字段,显示缩略图,是否在客户端接口上加字段还是新开接口,后台同事自行确认) |
| | 2079 | |
| | 2080 | 开发完成,连代理192.168.22.242 8888即能拿到数据或者页面 |
| | 2081 | 请求url:http://mrobot.pcauto.com.cn/v3/bbs/guessYouLike |
| | 2082 | HTTP请求方式:GET |
| | 2083 | 是否需要登录:false |
| | 2084 | 返回格式:json |
| | 2085 | 缓存方式:接口缓存 |
| | 2086 | 缓存时间:60分钟 |
| | 2087 | 请求参数:第一次进到论坛首页的时候,既没有cookie,也没有visitedFid, 就使用热门论坛的,这个逻辑交给app客户端处理,由客户端调用热门论坛的接口获取数据拼接visitedFid |
| | 2088 | cookie |
| | 2089 | visitedFid:访问过的版块id以D分隔,非必须参数 |
| | 2090 | 请求后端url:http://bbs.pcauto.com.cn/intf/guessYouLike.do?smallImg=true&bbsImgOnly=true&type=json&imgCount=3&viewCount=true |
| | 2091 | 说明: |
| | 2092 | visitedFid 访问过的版块id以D分隔,非必须参数 |
| | 2093 | type 输出格式,默认js,可以为json |
| | 2094 | var 当输出为js时,保存数据的变量名,默认为topiclist1 |
| | 2095 | containCoverOnly 是否只出含封面图的精华,默认false |
| | 2096 | bbsImgOnly 是否只出汽车论坛上传的图片,默认false |
| | 2097 | smallImg 是否把图片转为120x80格式,默认false |
| | 2098 | imgCount 每个帖子出的图片数量,默认2 |
| | 2099 | viewCount 值为true,表示出浏览数量 |
| | 2100 | 返回结果:(最多60个) |
| | 2101 | [ |
| | 2102 | { |
| | 2103 | "datatime": "2014-04-25 11:04", |
| | 2104 | "datatimemillis": 1398395080000, |
| | 2105 | "desc": "买车过程太痛苦了!不想回忆了![无语]开始看过很多车,雅阁,CC,君越,胜达,3系,C级,还有蒙迪欧。蒙迪欧第一眼就爱上了,外形控的不二选择!高科技配置很多!完...", |
| | 2106 | "forum": "奥迪A4L论坛", |
| | 2107 | "forumId": 14034, |
| | 2108 | "forumlink": "http://v15.pcauto.com.cn/forum-14359.html", |
| | 2109 | "replycount": 100, |
| | 2110 | "topic": "40TFSI个运作业来了!谁说没媳妇合影就不能火!!!!!", |
| | 2111 | "topicId": 4720505, |
| | 2112 | "topicimg": [], |
| | 2113 | "topiclink": "http://v15.pcauto.com.cn/topic-4720505.html", |
| | 2114 | "userId": 30421242, |
| | 2115 | "userface": "http://i1.3conline.com/images/upload/upc/face/30/42/12/42/30421242_100x100", |
| | 2116 | "userlink": "http://v21.pcauto.com.cn/30421242", |
| | 2117 | "username": “qz30421242”, |
| | 2118 | "thumbImg": 缩略图 |
| | 2119 | }, |
| | 2120 | { |
| | 2121 | "datatime": "2014-04-09 23:51", |
| | 2122 | "datatimemillis": 1397058682000, |
| | 2123 | "desc": " 跟拍奥迪与嫩模今日独家奉上精美图集~名车名模,快说,你对哪个心动了呀? 啦啦啦,上图啦,看美女啦! [图]先来张内饰,甜甜圈是不是特别的显眼...", |
| | 2124 | "forum": "奥迪A4L论坛", |
| | 2125 | "forumId": 14034, |
| | 2126 | "forumlink": "http://v15.pcauto.com.cn/forum-14359.html", |
| | 2127 | "replycount": 39, |
| | 2128 | "topic": "【名模名车】奥迪或嫰模,你要哪个?多图杀猫~", |
| | 2129 | "topicId": 4639676, |
| | 2130 | "topicimg": [], |
| | 2131 | "topiclink": "http://v15.pcauto.com.cn/topic-4639676.html", |
| | 2132 | "userId": 8803955, |
| | 2133 | "userface": "http://i1.3conline.com/images/upload/upc/face/88/03/95/5/8803955_100x100", |
| | 2134 | "userlink": "http://v21.pcauto.com.cn/8803955", |
| | 2135 | "username": “爱恨不平行”, |
| | 2136 | "thumbImg": 缩略图 |
| | 2137 | } |
| | 2138 | ] |
| | 2139 | }}} |
| | 2140 | |
| | 2141 | === 8.7wap页面 === |
| | 2142 | {{{ |
| | 2143 | 任务: |
| | 2144 | 手机绑定帐号 |
| | 2145 | 申请成为认证车主 |
| | 2146 | 有一个帖子被设置为精华帖 |
| | 2147 | 发表1个主题帖 |
| | 2148 | |
| | 2149 | 其他: |
| | 2150 | 常见问题(创建车友会) |
| | 2151 | 升级车友会 |
| | 2152 | }}} |
| | 2153 | |
| | 2154 | === 2.8上传图片接口 === |
| | 2155 | {{{ |
| | 2156 | 接口URL:/album/uploadPic.do |
| | 2157 | 说明:上传图片到车友会指定相册 |
| | 2158 | |
| | 2159 | 请求参数: |
| | 2160 | albumId:相册ID |
| | 2161 | userId:用户id,从登录信息取 |
| | 2162 | urls : 格式:名称@路径@尺寸,多张图片以”,”分割(上传原图url) |
| | 2163 | 如 abc@http://123.png@100x150 |
| | 2164 | |
| | 2165 | 是否登录:是 |
| | 2166 | 缓存时间:无 |
| | 2167 | 是否分页:否 |
| | 2168 | |
| | 2169 | 返回结果: |
| | 2170 | {code:0} |
| | 2171 | }}} |