歐飛SP 合作接口文檔OFCARD 系統(tǒng)http 接口協(xié)議(V5.5)說(shuō)明本文檔供SP 和本項(xiàng)目的后續(xù)開發(fā)維護(hù)人員使用，為了業(yè)務(wù)系統(tǒng)的安全，請(qǐng)嚴(yán)格不泄露本協(xié)議接口。在這個(gè)接口協(xié)議中，歐飛OFCARD

歐飛SP 合作接口文檔

OFCARD 系統(tǒng)http 接口協(xié)議(V5.5)

說(shuō)明

本文檔供SP 和本項(xiàng)目的后續(xù)開發(fā)維護(hù)人員使用，為了業(yè)務(wù)系統(tǒng)的安全，請(qǐng)嚴(yán)格不泄露本協(xié)議接口。

在這個(gè)接口協(xié)議中，歐飛OFCARD 作為內(nèi)容供應(yīng)商，我們稱之為CP ，調(diào)用我們接口的商戶作為一個(gè)業(yè)務(wù)點(diǎn)，我們稱之為SP 。 通過(guò)接口SP 能夠根據(jù)需要從CP 實(shí)時(shí)獲得需要的商品信息，可以提取卡密或者對(duì)帳號(hào)進(jìn)行實(shí)時(shí)充值。

本接口的業(yè)務(wù)邏輯基于歐飛直銷系統(tǒng)（esales.ofcard.com ），SP 使用該接口之前必須注冊(cè)成經(jīng)銷商或者直銷商，提供SP 服務(wù)器IP 地址，通知?dú)W飛工作人員開通Http 接口功能，歐飛為你分配相應(yīng)功能模塊和MD5 key值，你的登陸密碼不能設(shè)置的太簡(jiǎn)單，請(qǐng)不要向任何人，包括歐飛工作人員泄露你的直銷系統(tǒng)登陸密碼。

歐飛針對(duì)本協(xié)議接口沒有架設(shè)測(cè)試環(huán)境，拿到該接口的SP ，請(qǐng)直接進(jìn)入生產(chǎn)環(huán)境（地址和端口詳見各個(gè)功能模塊）進(jìn)行測(cè)試，SP 注冊(cè)后可以自行購(gòu)買一定數(shù)量的信用點(diǎn)（信用點(diǎn)可以理解成預(yù)存款，沒有信用點(diǎn)的情況下，SP 無(wú)法進(jìn)行提卡和充值），建議用編碼為360101的測(cè)試卡進(jìn)行提卡測(cè)試，用Q 幣進(jìn)行充值測(cè)試。

SP 可以登陸歐飛直銷系統(tǒng)查看交易記錄進(jìn)行對(duì)帳，也可以使用對(duì)帳接口進(jìn)行自動(dòng)對(duì)帳。 關(guān)于接口的另外幾點(diǎn)說(shuō)明：

- 該接口使用HTTP 協(xié)議，請(qǐng)求數(shù)據(jù)傳輸格式如下：

【接口URL 】? 【參數(shù)名稱1】=【參數(shù)值1】&【參數(shù)名稱2】=【參數(shù)值2】??

2、所有接口的應(yīng)答在HTTP 包體中將以XML 形式返回；

3、所有的接口請(qǐng)求通過(guò)后臺(tái)調(diào)用；

機(jī)密 第 1 頁(yè) 共 18 頁(yè)

歐飛SP 合作接口文檔

4、各參數(shù)的參數(shù)名全部為小寫；

5、歐飛服務(wù)器是放在電信機(jī)房，如果合作伙伴需要更快的接入速度，最好放在電信機(jī)房

6．其中文檔提到的“ ”是連接字符的意思。

7. 接口調(diào)用出現(xiàn)超時(shí)或其它錯(cuò)誤時(shí)，需聯(lián)系我們客服，或者主動(dòng)到平臺(tái)進(jìn)行核實(shí)。 協(xié)議的交互邏輯

機(jī)密 第 2 頁(yè)共 18 頁(yè)

歐飛SP 合作接口文檔

1用戶信息查詢接口（queryuserinfo.do ）

此接口可以查詢到SP 用戶的信用點(diǎn)余額，可以提醒SP 進(jìn)行補(bǔ)充信用點(diǎn)：

調(diào)用的鏈接如下：

返回的XML ：

-

1

1060.00

//收藏的商品編碼

//剩余信用點(diǎn)

2用戶收藏夾商品信息查詢接口（. 此接口停用）

-此接口停用

機(jī)密 第 3 頁(yè) 共 18 頁(yè)

歐飛SP 合作接口文檔

返回的內(nèi)容：

1

- < ret_cardinfos >

-

310202 //商品編號(hào)

40 //商品面值

27 //對(duì)應(yīng)SP 等級(jí)的結(jié)算價(jià)

32

30

29 //CP系統(tǒng)1級(jí)直銷價(jià) // CP系統(tǒng)2級(jí)直銷價(jià) // CP系統(tǒng)3級(jí)直銷價(jià)

40 //普通會(huì)員價(jià)（歐飛建議零售價(jià)）

0 //商品庫(kù)存（<=10顯示實(shí)際庫(kù)存，>10顯示為10） 6位QQ 號(hào) //商品名稱

6位QQ 號(hào) //商品別名

E

分隔符

3102//此商品所屬子類編碼

3//此商品所屬商品類型（1-實(shí)物商品，2-直充商品，3-卡密商品，

4-手機(jī)快沖，5-手機(jī)慢沖，6-支付商品）

例：如果可選值為”1-10,15,20,30”，那么可選數(shù)量為“1,2,3,4,5,6,7,8,9,10,15,20,30” //充值網(wǎng)址

????????????C

B????Internet???????????????????й??

3?????????GSM???????IP?綽???????? //商品說(shuō)明, 需URL 轉(zhuǎn)換

//用戶游戲區(qū)域

//服務(wù)器組

2008-06-10 09:46:46 //最后操作時(shí)間

//商品級(jí)別（E 類建議停止銷售） 1-10,15 //在線充產(chǎn)品可選數(shù)量，連續(xù)的用“-”表示，“, ”用作

3商品小類信息同步接口（querylist.do ）

機(jī)密 第 4 頁(yè) 共 18 頁(yè)

調(diào)用的鏈接如下：

返回的內(nèi)容：

-

1

-

-

2303 // 小類商品編碼

//小類商品名稱 23 //此子類商品所屬大類編碼 勁舞掛機(jī)寶貝

????????????

???????????θ?????????????? ???????????????????????