API中的對(duì)象怎么使用

本篇內(nèi)容主要講解“API中的對(duì)象怎么使用”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實(shí)用性強(qiáng)。下面就讓小編來帶大家學(xué)習(xí)“API中的對(duì)象怎么使用”吧!

1、API請(qǐng)求/響應(yīng)數(shù)據(jù)的JSON編碼

API的訪問請(qǐng)求與響應(yīng)都采用JSON編碼。下面是API中的常用對(duì)象。

1.1 通道 / Channel

通道對(duì)象示例如下：

{
   "channel_identifier": 21,
   "token_network_identifier": "0x2a65Aca4D5fC5B5C859090a6c34d164135398226",
   "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
   "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
   "balance": 25000000,
   "total_deposit": 35000000,
   "state": "opened",
   "settle_timeout": 500,
   "reveal_timeout": 40
}

通道對(duì)象包含如下字段：

• channel_identifier：通道的標(biāo)識(shí)，整數(shù)

• partner_address：對(duì)方地址， EIP55編碼的地址字符串，用來開啟一個(gè)通道

• token_address：代幣地址，EIP555編碼的代幣地址字符串，用于通道上的交易

• token_network_identifier：代幣網(wǎng)絡(luò)標(biāo)識(shí)符，EIP55編碼的代幣網(wǎng)絡(luò)標(biāo)識(shí)符

• balance：可用代幣余額，整數(shù)

• total_deposit：已存入通道合約的金額，整數(shù)

• state：通道的當(dāng)前狀態(tài)，字符串，可能的值包括：opened - 通道已開啟 closed - 通道已關(guān)閉 settled - 通道已關(guān)閉而且已清算

• settle_timeout：通道清算超時(shí)區(qū)塊數(shù)，整數(shù)

• reveal_timeout：允許的最大揭示超時(shí)區(qū)塊數(shù)，整數(shù)

1.2 通道事件 / Event

通道事件也編碼為JSON對(duì)象，事件的參數(shù)作為事件對(duì)象的屬性。為了便于區(qū)分不同類型的事件，在事件對(duì)象上額外添加了event_type和block_number屬性。

2、API錯(cuò)誤信息

對(duì)于不成功的API請(qǐng)求，會(huì)返回對(duì)應(yīng)的http狀態(tài)碼，例如409沖突或400錯(cuò)誤請(qǐng)求等，同時(shí)也會(huì)在返回的json對(duì)象中附帶errors字段，你可以用來獲取關(guān)于錯(cuò)誤的詳細(xì)信息。但是，需要指出的是，如果Raiden不能處理收到的請(qǐng)求并且拋出異常，那么將返回http狀態(tài)碼 500，這時(shí)返回的就不是json對(duì)象，而只是一個(gè)字符串消息Internal server error。 這是由于我們依賴于其他開發(fā)庫來實(shí)現(xiàn)API，發(fā)生異常時(shí)我們無法正常處理響應(yīng)消息。

無論如何，我們認(rèn)為500錯(cuò)誤是Raiden的bug，如果你碰到這種現(xiàn)象，請(qǐng)反饋給我們。

到此，相信大家對(duì)“API中的對(duì)象怎么使用”有了更深的了解，不妨來實(shí)際操作一番吧！這里是億速云網(wǎng)站，更多相關(guān)內(nèi)容可以進(jìn)入相關(guān)頻道進(jìn)行查詢，關(guān)注我們，繼續(xù)學(xué)習(xí)！