在使用RSSBus API之前要具備幾個條件：

1.RSSBus授權的Authtoken，相當於一個使用API的key，需要先進行授權才可以使用。

2.RSSBus授權的訪問IP，在RSSBus伺服器上，需要先配置你的訪問IP地址，不然將無法呼叫RSSBus API。

3.如果你是想通過呼叫API來操作中間資料庫的話，還必須在RSSBus伺服器上使用API Port連線資料庫，並對相關的表/檢視進行授權。

下面以SQLServer資料庫為例，主要介紹如何使用API對資料表進行操作：

RSSBus API請求型別：

請求型別共分為四種：GET、POST、DELETE、PUT---四種method分別對應：查詢、插入、刪除、修改四種操作。

資料型別為json。

用部署在本地的RSSBus環境進行呼叫說明：

1.首先登陸RSSBus，在API Port中的Users Tab 新增user，會自動生成一個Authtoken：

2.然後在Server Tab中新增信任IP地址：

3.在connection Tab中連線資料庫

4.新增資料庫資源同時配置許可權

上述步驟都完成後，就可以使用http請求呼叫API了。

比如現在要查詢order_header表的資料，就可以發一個GET請求：

對應的URL為：

使用postman呼叫API：

下面詳細敘述一下附加條件和引數的請求。

方法一：假如想查詢主鍵id為5的order表資訊，可以直接在後面加 (5)

http://localhost:8201/port/TestAPI/api.rsc/Grant_dbo_order_header(5)

方法二：也可以在URL的最後拼一個filter，例如：

http://localhost:8201/port/TestAPI/api.rsc/Grant_dbo_order_position?$filter=header_id eq 5

查詢結果如下圖所示：

這種方法可以加多個條件進行過濾，例：

注：此方法只能用於GET請求，其餘型別的請求均不適用。

方法三：URL可以寫成：

也可以附加多個條件，使用“,”分隔：

http://localhost:8201/port/TestAPI/api.rsc/Grant_dbo_order_position(header_id=5,id=3)

查詢結果如下：

可以看出來與方法二效果一樣，但是此方法可以用於別的請求型別，DELETE/PUT請求都適用，所以推薦使用方法三進行API呼叫。

最後附一個使用C#呼叫API的示例工程：

下載C#示例