當(dāng)發(fā)起一個(gè)rpc調(diào)用時(shí),除通知之外,服務(wù)端都必須回復(fù)響應(yīng)。響應(yīng)表示為一個(gè)JSON對(duì)象,使用以下成員:
jsonrpc
指定JSON-RPC協(xié)議版本的字符串,必須準(zhǔn)確寫為“2.0”
result
該成員在成功時(shí)必須包含。
當(dāng)調(diào)用方法引起錯(cuò)誤時(shí)必須不包含該成員。
服務(wù)端中的被調(diào)用方法決定了該成員的值。
error
該成員在失敗是必須包含。
當(dāng)沒有引起錯(cuò)誤的時(shí)必須不包含該成員。
該成員參數(shù)值必須為5.1中定義的對(duì)象。
id
該成員必須包含。
該成員值必須于請(qǐng)求對(duì)象中的id成員值一致。
若在檢查請(qǐng)求對(duì)象id時(shí)錯(cuò)誤(例如參數(shù)錯(cuò)誤或無(wú)效請(qǐng)求),則該值必須為空值。
響應(yīng)對(duì)象必須包含result或error成員,但兩個(gè)成員必須不能同時(shí)包含。
當(dāng)一個(gè)rpc調(diào)用遇到錯(cuò)誤時(shí),返回的響應(yīng)對(duì)象必須包含錯(cuò)誤成員參數(shù),并且為帶有下列成員參數(shù)的對(duì)象:
code
使用數(shù)值表示該異常的錯(cuò)誤類型。 必須為整數(shù)。
message
對(duì)該錯(cuò)誤的簡(jiǎn)單描述字符串。 該描述應(yīng)盡量限定在簡(jiǎn)短的一句話。
data
包含關(guān)于錯(cuò)誤附加信息的基本類型或結(jié)構(gòu)化類型。該成員可忽略。 該成員值由服務(wù)端定義(例如詳細(xì)的錯(cuò)誤信息,嵌套的錯(cuò)誤等)。
-32768至-32000為保留的預(yù)定義錯(cuò)誤代碼。在該范圍內(nèi)的錯(cuò)誤代碼不能被明確定義,保留下列以供將來(lái)使用。錯(cuò)誤代碼基本與XML-RPC建議的一樣,url:?http://xmlrpc-epi.sourceforge.net/specs/rfc.fault_codes.php
code | message | meaning |
---|---|---|
-32700 | Parse error語(yǔ)法解析錯(cuò)誤 | 服務(wù)端接收到無(wú)效的json。該錯(cuò)誤發(fā)送于服務(wù)器嘗試解析json文本 |
-32600 | Invalid Request無(wú)效請(qǐng)求 | 發(fā)送的json不是一個(gè)有效的請(qǐng)求對(duì)象。 |
-32601 | Method not found找不到方法 | 該方法不存在或無(wú)效 |
-32602 | Invalid params無(wú)效的參數(shù) | 無(wú)效的方法參數(shù)。 |
-32603 | Internal error內(nèi)部錯(cuò)誤 | JSON-RPC內(nèi)部錯(cuò)誤。 |
-32000 to -32099 | Server error服務(wù)端錯(cuò)誤 | 預(yù)留用于自定義的服務(wù)器錯(cuò)誤。 |
除此之外剩余的錯(cuò)誤類型代碼可供應(yīng)用程序作為自定義錯(cuò)誤。
更多建議: