遠端桌面-登出
# FastWeb遠端桌面-登出
以下我們以Myrtille登出的說明為例,說明在設定介面整合過程中的注意事項。如果尚未了解Myrtille,請參閱Myrtille說明,以下是Myrtille登出的介面說明:
- 介面URL
http://{server}/Myrtille/api/Disconnection/Disconnect?connectionid={connectionId}
- 請求方式
GET
- Content-Type
form-data
- 請求Query參數
參數名 | 示例值 | 參數型別 | 是否必填 | 參數描述 |
---|---|---|---|---|
connectionid | ec580c99-977d-4462-ab1f-b0adb42a8399 | String | 是 | 連線ID |
- 成功響應示例
true
# 1. 分析
根據對上述介面的地址分析,可以將地址拆分成基礎地址與請求參數兩部分。其中http://{server}
是作為基本的請求地址部分,Myrtille/api/Disconnection/Disconnect
部分作為額外的URL資訊來使用。?
後側的內容為參數部分,表示為連線的id資訊。
點選[系統工具]
-[介面整合(Server)]
,打開介面整合
界面,輸入API供應商以及API伺服器的地址,填寫相關說明,點選[儲存]
。
點選[系統工具]
-[介面整合(API)]
,打開介面整合(API)
界面,在其中設定Myrtille的RestAPI請求資訊。
點選[新增]
按鈕,打開新增API
界面,在其中輸入API的資訊。
API名稱與API描述部分可自行設定。
API供應商
處選擇剛才建立的API供應商。
上文的API說明中已指出使用的Content-Type
以及請求方法
,此處按照說明中提供的內容選擇。
URL
處設定額外的路徑資訊,上文的API中指定了Myrtille/api/Disconnection/Disconnect
,則此處填入。
參數部分改寫connectionid={connectionId}
為connectionid=%s
。
儲存后,點選[儲存]
按鈕,返回管理頁面。
# 2. 用法
在遠端桌面-登錄的基礎上再增加TUgButton
與TUgRestApi
,分別命名為btnMyrtilleLogout
與restMyrtilleLogout
,雙擊restMyrtilleLogout
,設定其繫結的API為遠端桌面-登出
。分別設定btnMyrtilleLogout
的OnClick
事件與restMyrtilleLogout
的ResultData
事件,設定程式示例如下,詳情可參考RestAPI綜合運用2。
procedure btnMtrtilleLogoutOnClick(sender: tobject);
//Myrtille登出
begin
restMyrtillelogout.Params.Text := Format(restMyrtillelogout.Params.Text,[myrtilleAuthToken]);
restMyrtillelogout.Send;
end;
2
3
4
5
6