騰迅平台接入筆記

騰迅平台接入筆記

CanvasURL

公共參數相關

什麼是OpenID, OpenKey？

OpenID：使用者的唯一辨別，根據APPID以及QQ号碼生成，同樣的QQ号在不同應用中OpenID也不一樣。詳見：概念和術語#OpenID。

OpenKey：使用者的會話密鑰（session key），同一個使用者如果在不同時間打開多個應用頁面，頁面傳回的OpenKey是不一樣的，這些openkey在各自的頁面都可用。詳見：概念和術語#OpenID。

OpenID是否唯一？

OpenID根據APPID以及QQ号碼生成，在每個應用中都是唯一，作為使用者的唯一辨別。

是否能通過OpenAPI直接擷取使用者QQ号？

不能。使用者在應用中的唯一辨別是OpenID，騰訊開放平台不提供使用者的QQ号。

如何擷取OpenID和Openkey等參數？

Step1: 了解什麼是CanvasURL

CanvasURL也稱之為應用開發位址。（你可能需要了解什麼是CanvasURL。）

CanvasURL在2種場景下被引用：

-對于開發中的應用，從“開發者”應用中跳轉到應用時，需要引用CanvasURL才能進入到應用。

-對于符合接入規範的應用，通過應用平台位址跳轉到應用時，需要引用CanvasURL才能進入應用。

1.5 CanvasURL與應用平台位址

CanvasURL（即應用開發位址）：

（1）也稱之為應用開發位址，CanvasURL不會展現在位址欄，隻是用于跳轉時引用（見下圖示注）。

（2）CanvasURL由開發者填寫（登入op.open.qq.com後進入管理中心，選擇1個應用進入，在“應用管理”tab下的“平台資訊”頁面可看到應用開發位址填寫框），它可以是一個CGI Service的位址，也可以是一個HTML頁面。

（3）對于hosting應用來說，CanvasURL的域名是由平台配置設定的。

例如某個hosting應用其在空間平台的CanvasURL為如下，其中app10507.qzone.qzoneapp.com由平台配置設定：

<a href="http://app10507.qzone.qzoneapp.com?openid=xxxx&amp;openkey=xxx&amp;pf=qzone&amp;pfkey=xxx...">http://app10507.qzone.qzoneapp.com?openid=xxxx&amp;openkey=xxx&amp;pf=qzone&amp;pfkey=xxx...</a>

送出申請前，該位址可以任意填寫；

準備送出申請時，需要改為實際調用位址，應用隻需要在平台配置設定的域名後加上詳細位址。對于多區多服應用，平台自動将配置設定的域名比對至選區配置頁，不允許修改。

（4）對于non-hosting應用來說，CanvasURL沒有任何限制。

（5）CanvasURL在2種場景下被引用：

-對于開發中的應用，從“開發者”應用中跳轉到應用時，需要引用CanvasURL才能進入到應用（你可能需要了解如何進入“開發者”應用？）。

-對于符合要求的應用，通過應用平台位址跳轉到應用時，需要引用CanvasURL才能進入應用。

注意：

（1）跳轉到應用後，平台會在CanvasURL後帶一些參數，應用可以通過解析CanvasURL來擷取這些參數的值。

CanvasURL後一定會帶的參數有：openid,openkey,pf,pfkey

根據場景不同可能會帶的參數有：invkey,iopenid,itime,source,app_custom

invkey：邀請驗證Key，為加密串，可參考v3/spread/verify_invkey中的說明；

iopenid：發起邀請者的openid；

itime：邀請時間；

source：由開發者自定義該參數内容，用于判斷請求來源，可參考fusion2.dialog.sendRequest中的說明。

app_custom：由開發者自定義該參數，與source結合使用，可參考fusion2.dialog.sendRequest中的說明。

如果不知道如何解析CanvasURL以擷取這些參數，點選這裡；

騰訊開放平台聯調工具集

<a href="http://open.qq.com/tools">http://open.qq.com/tools</a>

在建立應用時，開發者需要選擇是“騰訊托管” 還是“非騰訊托管” 。

如果選擇了“騰訊托管”，還可以選擇是單區單服還是多區多服。

這裡有一些規定和建議：

為了保護使用者資料，騰訊規定所有遊戲類應用都必須選擇“托管模式” 。

如果遊戲類應用選擇了“非托管模式”，在送出上線申請時将被駁回。

遊戲類，社交化工具類，社交化電子商務類等需要用到關系鍊的應用，建議選擇“托管模式” 。

選擇“托管模式”後，隻有網頁遊戲類可以選擇多區多服。

如果應用自有資料庫裡面已經存在有大量重要的資料，不想将這些資料遷移到騰訊的伺服器上，為了資料互通，隻能選擇“非騰訊托管”模式。

騰訊羅盤是：

（1）騰訊提供的雲計算服務之一；

（2）一款綜合資料産品，中文名為“騰訊羅盤”，英文名為“compass”；

（3）為騰訊開放平台的應用開發者提供權威的資料分析服務；

（4）緻力于海量資料的分析挖掘和可視化展現；

（5）提供平台分析和進階分析服務，開發者可根據自身需要選擇合适的資料分析服務。

應用圖示

圖檔簡潔清晰，重點突出，界面層次清晰。

圖檔不得描邊、圓角。

圖檔不得添加“new、hot、熱、推薦”等标注。

圖檔不得直接或間接使用騰訊公司或其它公司圖案元素。

圖檔中如需添加文字，文字應與應用名稱和應用内容相符。

詳見：前端頁面規範#3. 應用圖示以及預覽圖規格與規範。

新手引導

有新使用者引導，能確定第一次進入應用的使用者可以對産品功能、流程等進行大緻了解。

對不良信譽應用的處罰規則

當出現以下情況中的任意一種，開發者賬号将被列入不良信譽名單，并進行相應的處罰。

不良信譽行為 處罰方式

伺服器欠費，未繳清欠款，導緻應用下線。 1. 添加至不良信譽名單中的開發者帳号，資質會被當機，且不能修改；

開發者在騰訊開放平台将無法建立新應用。

開發者名下出現3款及以上應用，被核實存在侵權（包括但不限于題材、圖示等）及盜版。

每自然年，開發者名下的應用出現營運一級違規達到三次及以上。

送出虛假的開發者資質或應用資質資訊。

jiahuafu