新版接口遷移指南 · 清博大數據開放平臺

#### 為什么要遷移到新版接口全新的新版（[api.gsdata.cn](http://api.gsdata.cn)）[v2]接口較舊版（[open.gsdata.cn/api](http://open.gsdata.cn/api)）[v1]接口具有更豐富的功能、更規范、更可控等優勢，很好地滿足了開發者的需求。 **新版接口較舊版接口的優勢** 1. 更多功能 * V2較V1新增了大量接口，輿情內容分析類、輿情方案、輿情傳播、微博榜單、微博分組； * 另外，企業背景、知識產權、法律風險等工商類數據也即將開放。 2. 更規范 * 統一參數、返回值字段，全部小寫字母，單詞和單詞之間用“_”鏈接 * 接口URI，全部采用：請求方式+域+版本號+接口名+參數 * 統一的新錯誤返回值格式及錯誤碼 * 核心字段：微信、微博、分組全部標準化，避免核心字段在不同接口中返回值不同，從而降低開發成本 * 接口盡量按照 OPENAPI 規范來實現 * 接口默認返回xml 結構體，聲明頭信息之后返回 json 結構話文檔 3. 更可控 * 接口使用更加透明,使用量，消耗點數依依記錄 * 接口在正常返回的情況下才會扣點，比如http 狀態碼為200，201，204 的情況下進行扣費 * 提供ip白名單 ### V1到V2怎么遷移 V1遷移到V2主要需要完成簽名機制的轉換及完成V1原有接口與V2中新接口的對應替換。 ### V1接口遷移到V2接口在[創建應用](http://open.gsdata.cn/)并實現[簽名](default.md)后，接下來需要將應用使用的V1版接口對應遷移到V2版接口。此時需要根據新接口的調用地址、調用方式、參數、返回值、錯誤信息處理來進行代碼的改造。以下是V2版接口與V1版接口的對應列表，部分舊版接口由于用戶投訴或性能等原因已不再提供，同時新版接口提供豐富的高級接口開放優質應用申請，您可以直接在應用控制臺中提交高級接口申請。如果現有接口未能滿足您的需求，歡迎進入開發者交流群（4000019）進行反饋，我們將根據開發者需求強度及清博公司的利益權衡適度開放。 |新版V2接口 | 對應老版V1接口|接口說明 | | --- | --- | --- | | [/pubsent/v1/contents](http://open.gsdata.cn/article/info?id=1) | |根據方案編號獲取內容列表 | | [/pubsent/v1/contents/emotions](http://open.gsdata.cn/article/info?id=2) | |根據方案編號分析情感屬性 | | [/pubsent/v1/contents/hot-words](http://open.gsdata.cn/article/info?id=3) | |根據方案編號獲取熱門主題詞 | | [/pubsent/v1/contents/assortments](http://open.gsdata.cn/article/info?id=4) | |根據方案編號分析文章類型 | | [/pubsent/v1/plans](http://open.gsdata.cn/article/info?id=5) | |獲取當前用戶的方案列表 | | [/pubsent/v1/plans/pub-subs](http://open.gsdata.cn/article/info?id=6) | |獲取公共方案列表 | | [/pubsent/v1/trans/media-distributions](http://open.gsdata.cn/article/info?id=7) | |根據方案編號進行媒體分布的傳播分析 | | [/pubsent/v1/trans/active-medias](http://open.gsdata.cn/article/info?id=10) | |根據方案編號以及媒體累類型分析媒體機構發布的數量 | | [/pubsent/v1/trans/release-areas](http://open.gsdata.cn/article/info?id=11) | |根據方案編號分析發布熱區 | | [/pubsent/v1/trans/areas](http://open.gsdata.cn/article/info?id=12) | |根據方案編號分析提及熱區 | | [/pubsent/v1/weibos/hot-accounts](http://open.gsdata.cn/article/info?id=13) | |根據方案編號分析微博的賬號 | | [/pubsent/v1/weibos/hot-areas](http://open.gsdata.cn/article/info?id=14) | |根據方案編號分析微博的發布熱區 | | [/pubsent/v1/weibos/auth-types](http://open.gsdata.cn/article/info?id=15) | |根據方案編號分析微博的賬號類型 | | [/pubsent/v1/weibos/fans-genders](http://open.gsdata.cn/article/info?id=16) | |根據方案編號分析微博粉絲的性別分布 | | [/pubsent/v1/weibos/fans-qualitys](http://open.gsdata.cn/article/info?id=17) | |根據方案編號分析微博大v粉絲數量的分布 | | [/pubsent/v1/weixins/hot-accounts](http://open.gsdata.cn/article/info?id=18) | |根據方案編號分析微信的熱門賬號 | | [/pubsent/v1/weixins/hot-areas](http://open.gsdata.cn/article/info?id=19) | |根據方案編號分析微信的發布熱區 | | [/pubsent/v1/weixins/auth-types](http://open.gsdata.cn/article/info?id=20) | |根據方案編號分析微信的賬號類型 | | [/pubsent/v1/weixins/positions](http://open.gsdata.cn/article/info?id=21) | |根據方案編號分析微信的文章位置 | | [/pubsent/v1/weixins/wcis](http://open.gsdata.cn/article/info?id=22) | |根據方案編號分析微信的WCI分布 | 1點 | | [/weibo/v1/articles](http://open.gsdata.cn/article/info?id=23) | |微博的博文列表最多返回50條,默認20條 | | [/weixin/v1/articles](http://open.gsdata.cn/article/info?id=24) | [/api/wx/opensearchapi/content_keyword_search](http://open.gsdata.cn/api/wx/opensearchapi/content_keyword_search.html)| 微信文章列表最多返回50條,默認20條 | | [/weixin/v1/articles/real-times](http://open.gsdata.cn/article/info?id=34) | [/api/wx/wxapi/wx_content](http://open.gsdata.cn/api/wx/wxapi/wx_content.html)|文章地址根據文章的地址實時獲取文章正文 | 1點 | | [/weixin/v1/articles/key-words](http://open.gsdata.cn/article/info?id=80) | |根據文章內容獲取關鍵詞 | | [/weixin/v1/articles/week-read-nums](http://open.gsdata.cn/article/info?id=82) | [/api/wx/wxapi/wx_week_readnum](http://open.gsdata.cn/api/wx/wxapi/wx_week_readnum.html)|通過本系統nickname_id或微信文章url地址或者sn獲取距發布時間七日時間閱讀點贊數(暫時僅支持最近一個月的文章) | | [/weixin/v1/tests](http://open.gsdata.cn/article/info?id=26) | | 接口測試 | | [/weixin/v1/tests](http://open.gsdata.cn/article/info?id=31) | |post請求接口測試 | | [/weixin/v1/tests/unames](http://open.gsdata.cn/article/info?id=76) | |delete請求接口測試 | | [/weixin/v1/users](http://open.gsdata.cn/article/info?id=27) | [/api/wx/wxapi/nickname_one](http://open.gsdata.cn/api/wx/wxapi/nickname_one.html)|微信公眾號列表 | | [/weixin/v1/users/rank-days](http://open.gsdata.cn/article/info?id=28) | [/api/wx/wxapi/nickname_mark](http://open.gsdata.cn/api/wx/wxapi/nickname_mark.html)|根據微信名稱獲取排名 | | [/weixin/v1/users/batch-rank-days](http://open.gsdata.cn/article/info?id=29) | |根據微信名稱批量獲取排名 | | [/weixin/v1/users/batch-acounts](http://open.gsdata.cn/article/info?id=30) | |獲取最近七天排名 | | 即將上線[/weixin/v1/users/estimate-fans](http://open.gsdata.cn/article#) | [/api/wx/wxapi/getYGFS](http://open.gsdata.cn/api/wx/wxapi/getYGFS.html)|根據微信號或者微信昵稱獲取預估的粉絲數 | | [/weixin/v1/groups](http://open.gsdata.cn/article/info?id=35) | [/api/wx/wxapi/group_name](http://open.gsdata.cn/api/wx/wxapi/group_name.html)|返回微信分組名稱以及分組id | | [/weixin/v1/groups/nicknames](http://open.gsdata.cn/article/info?id=36) |[/api/wx/wxapi/del_nickname_In_group](http://open.gsdata.cn/api/wx/wxapi/del_nickname_In_group.html) |根據nickname編號刪除當前用戶分組內微信公眾號 | | [/weixin/v1/groups/wxnames](http://open.gsdata.cn/article/info?id=37) | [/api/wx/wxapi/del_wxname_In_group](http://open.gsdata.cn/api/wx/wxapi/del_wxname_In_group.html)|根據wx_name刪除本用戶分組內微信公眾號 | | [/weixin/v1/groups](http://open.gsdata.cn/article/info?id=64) | [/api/wx/wxapi/addWxGroup](http://open.gsdata.cn/api/wx/wxapi/addWxGroup.html)|創建微信分組(微信自定義榜單) | | [/weixin/v1/groups/wxnames](http://open.gsdata.cn/article/info?id=65) |[/api/wx/wxapi/add_wx_to_group](http://open.gsdata.cn/api/wx/wxapi/add_wx_to_group) |添加微信公眾賬號到分組并返回公眾號相關信息 | 1點 | | [/weixin/v1/groups/acounts](http://open.gsdata.cn/article/info?id=78) |[/api/wx/wxapi/add_wx_to_group_by_url](http://open.gsdata.cn/api/wx/wxapi/add_wx_to_group_by_url.html) |根據微信biz或者文章url添加微信賬號到分組并返回公眾號相關信息,參數優先級nickname_id>biz>url | 1點 | | 即將上線[/weixin/v1/groups/acounts](http://open.gsdata.cn/article#) | [/api/wx/wxapi/nickname_group](http://open.gsdata.cn/api/wx/wxapi/nickname_group.html) |查看當前用戶某個分組內的微信賬號信息 | | 即將上線[/weixin/v1/groups/articles](http://open.gsdata.cn/article#) |[/api/wx/wxapi/group_data](http://open.gsdata.cn/api/wx/wxapi/group_data.html) |查看當前用戶自有分組內的微信賬號文章列表 | | [/weixin/v1/ranks](http://open.gsdata.cn/article/info?id=38) | [/api/wx/wxapi/result_day](http://open.gsdata.cn/api/wx/wxapi/result_day.html) |微信日榜 | | [/weixin/v1/ranks/weeks](http://open.gsdata.cn/article/info?id=39) | [/api/wx/wxapi/result_week](http://open.gsdata.cn/api/wx/wxapi/result_week.html) |微信周榜 | | [/weixin/v1/ranks/months](http://open.gsdata.cn/article/info?id=85) |[/api/wx/wxapi/result_month](http://open.gsdata.cn/api/wx/wxapi/result_month.html) |微信月度榜單 | | [/weibo/v1/groups](http://open.gsdata.cn/article/info?id=63) | |獲取系統用戶所創建的微博分組信息 | | [/weibo/v1/groups](http://open.gsdata.cn/article/info?id=66) | |創建微博分組(微博自定義榜單) | | [/weibo/v1/groups/acounts](http://open.gsdata.cn/article/info?id=67) | |當前分組中的賬號信息 | | [/weibo/v1/groups/acounts](http://open.gsdata.cn/article/info?id=68) | |將微博賬號添加到分組當中 | | [/weibo/v1/groups/acounts](http://open.gsdata.cn/article/info?id=69) | |從當前分組中刪除微博賬號 | | [/weibo/v1/ranks](http://open.gsdata.cn/article/info?id=86) | |微博日榜 | | [/weibo/v1/ranks/weeks](http://open.gsdata.cn/article/info?id=87) | |微博周榜 | | [/weibo/v1/ranks/months](http://open.gsdata.cn/article/info?id=88) | |微博月度榜單 | V2中已廢棄或暫未支持的V1接口 | 接口地址| 接口說明 | | --- | --- | | [/api/sys/sysapi/user_info](http://open.gsdata.cn/api/sys/sysapi/user_info.html) | 根據用戶名稱查詢用戶信息 | | [/api/sys/sysapi/login_user](http://open.gsdata.cn/api/sys/sysapi/login_user.html) | 用戶登陸驗證 | | [/api/sys/sysapi/check_user](http://open.gsdata.cn/api/sys/sysapi/check_user.html) | 用戶名驗證 | | [/api/wx/wxapi/result_tables](http://open.gsdata.cn/api/wx/wxapi/result_tables.html) | 返回當月所有統計表（日，周） | | [/api/wx/opensearchapi/content_list](http://open.gsdata.cn/api/wx/opensearchapi/content_list.html) | 根據條件搜索公眾號某段時間內的文章信息| | [/api/wx/wxapi/nickname](http://open.gsdata.cn/api/wx/wxapi/nickname.html) | 通過UID返回用戶分組及各分組內的公眾號(含最新發布的一條文章)列表 |