1. 程式人生 > >RSSBus API呼叫示例及說明(資料庫篇)

RSSBus API呼叫示例及說明(資料庫篇)

在使用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_header(id=5)

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

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

查詢結果如下:

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

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