本説明頁面上的資訊同時適用於 CXone Studio 和 Desktop Studio。
API 動作是允許您在指令碼中使用 CXone API 的 Studio 動作。 您可以使用動作，而不是使用傳統的整合方法，例如使用 snippet 或 RestAPI 動作。 API 動作均位於 Desktop Studio 中的框架標籤。
API 動作與標準 Studio 動作不同。 目前，在線上說明中沒有它們的記錄。 然而，與 API 動作相對應的 API 在CXone開發者入口網站
中有記錄。 在您的指令碼中使用 API 動作時，可以使用這個文件。
不是每個 CXone API 在 Studio 中都有相應的 API 動作。
API 動作要求安全使用者。 您可以使用 SETSECURITYUSER 動作在指令碼中設定安全使用者。
API 動作版本
隨著 CXone API 的新版本發佈，相應動作的新版本可能會在 Studio 中發佈。 一般來說，最好使用最新的動作版本。 舊版本在大多數情況下仍然有效。 您可以嘗試不同的版本，看看哪些版本有效並提供您需要的功能。
一些 API 動作在動作名稱中包含了版本。 當您在「框架」標籤上看到動作的樹狀結構時，就可以看到它。 不是所有的 API 動作均包含版本號。 對於這些動作，可以動作的擴展屬性中找到版本。 只有在「框架」標籤中選擇動作時，才能在「屬性」標籤中看到擴展屬性。
不是每個版本的每個 API 均在 Studio 中有相應的動作。
檢視 API 動作擴展屬性
此任務只能在 Desktop Studio 中完成。
檢視圖像
- 在 Studio 中，重新排列標籤，以便您可以同時看到「屬性」標籤和「框架」標籤。
- 在「框架」標籤上，點擊 API 動作。
- 在「屬性」標籤上，現在可以看到該動作的擴展屬性。 特別是，在了解一個 API 動作時，以下屬性很有幫助：
- 雜項 > 參數 > 動詞：此屬性顯示與該動作相關的方法或動詞。
- 雜項 > 參數 > 版本：此屬性顯示您的 API 的版本。
- 雜項 > Web > URI：此屬性在開發者入口網站中搜尋 API 文件時很有用。
雜項 > 參數：在「參數」部分，可以展開屬性來檢視關於每個動作屬性的額外資訊。
尋找 API 文件
此任務只能使用 Desktop Studio 完成。
CXone API 在CXone開發者入口網站中有記錄。 Studio 中的 API 動作沒有直接連結到與其 API 對應的文件。 然而，您可以使用動作的擴展屬性中的資訊來幫助您找到文件。
使用 URI 需要熟悉整個 CXone 系統和不同的CXone API。 這是因為確定哪個 API 與 Studio 中的某個動作相匹配並不總是那麼簡單。 了解 聯絡人 在 CXone的一般流程有助於正確理解動作的 URI，並將其中的線索套用到開發人員門戶網站的 API 文件結構。 此部分中的範例展示了可能需要的解釋。
開發者入口網站 API 部分的主頁提供了每個 CXone API 的概述。
範例 1
有時，動作與其 API 之間有直接的關聯性：
- 動作：
- URI：
- API 文件
根據動作的名稱和 URI，首先要考慮的兩個 API 是客服專員 API 和管理 API。 透過檢視每個 API 的 AP 調用清單，可以排除「客服專員 API」。 如下圖所示，其描述表明，其是用來管理客服專員會話的，似乎沒有任何與技能有關的通話。
「管理 API」表明，其與技能等系統物件一起工作。 如下圖所示，該 API 的可用 API 調用清單包括技能。
當您展開「技能」部分，其中一個終點是
範例 2
如以下範例所示，有時相關性並不明顯。 在這樣的情況下，您需要運用自己對 CXone API 和平台本身的了解來找到相應的 API 終點。 —
- 動作：
- URI：
- API 文件：/API/RealTimeDataAPI#/RealTime/ActiveContacts
根據這個動作的名稱和 URI，並不能立即看出應該先查看哪個 API。 如果您不確定從哪裡開始，可以翻閱每個 API 的文件，檢查任何與聯絡人有關的部分。 「管理 API」是唯一一個有頂層聯絡部分的 API。 很遺憾，這個 API 不包含與活躍聯絡人有關的終點。
這時，您可以在行動名稱和 URI 中鍵入活躍字樣。 根據您對 CXone 的了解，您知道活躍表示目前正在處理的聯絡人。 這使您可以更仔細地觀察即時資料 API。 這個 API 只有一個部分，當您展開它時，即可看到其中一個終點是
