मेन्यू

एपीआई सहयोग के साथ आंतरिक संचालन को स्वचालित करें

विषयसूची

एपीआई सहयोग

चैट और मैसेंजर एपीआई का उपयोग करके, आप आसानी से बाहरी सिस्टम और प्रोग्राम से लिंक कर सकते हैं।
एपीआई एकीकरण निम्नलिखित प्रसंस्करण को सक्षम बनाता है।

  • आंतरिक सिस्टम से लिंक करता है और व्यावसायिक डेटा को चैट रूम में सूचित करता है
  • सिस्टम त्रुटियों का पता लगाएं और संबंधित पक्षों को सूचित करें
  • इन-हाउस ग्रुपवेयर से वेब कॉन्फ्रेंस लिंकेज
  • शेड्यूल और सम्मेलन कक्ष आरक्षण की जानकारी प्राप्त करें और अन्य प्रणालियों से लिंक करें
API 連携はクラウド Enterprise / オンプレミス Ultimate 以上のプランが必要です。

एपीआई टोकन और एपीआई इंटरफ़ेस

प्रबंधन स्क्रीन से एपीआई टोकन प्राप्त करना

एपीआई एकीकरण करते समय, पहले एक एपीआई टोकन प्राप्त करें।

कृपया प्राप्त एपीआईटोकन/सर्वरयूआरएल को नीचे दिए गए "एपीआई इंटरफ़ेस" में बताए अनुसार जावास्क्रिप्ट/कर्ल में पास करें।

कृपया एपीआई टोकन को सावधानी से संभालें क्योंकि यह पासवर्ड के समान है।

एपीआई इंटरफ़ेस

जावास्क्रिप्ट/कर्ल कमांड लाइन का उपयोग एपीआई इंटरफ़ेस के रूप में किया जा सकता है। नीचे दिए गए दोनों नमूने JSON प्रारूप में सम्मेलन कक्ष पंजीकरण जानकारी प्राप्त कर सकते हैं।

ऐसे वातावरण में जहां नियमित एसएसएल लागू नहीं होता है, सर्वरयूआरएल HTTP 8080 पोर्ट होगा।

जावास्क्रिप्ट

let config = {
	"apiToken": "QIQVOSvRJHrQElDwj20x******",
	"serverURL": "https://*****************"
}
let client = new CAMAPIClient(config);
let response = await client.getConferenceRooms();

कर्ल कमांड लाइन

curl -H "x-cam-apiToken:token******" ${serverURL}/getConferenceRooms

कोई भी HTTP एक्सेस प्रोग्राम

इसे किसी HTTP एक्सेस प्रोग्राम से भी जोड़ा जा सकता है।

एपीआई नमूना स्क्रीन

एक नमूना यूआरएल है जहां आप आसानी से एपीआई निष्पादन का प्रयास कर सकते हैं। यदि आप इसे परीक्षण के लिए उपयोग करना चाहते हैं, तो कृपया पूछताछ फ़ॉर्म से हमसे संपर्क करें।

संदेश एपीआई

मेसेज भेजें

एक संदेश भेजो।

नमूना

मैसेंजर में यूजर आईडी निर्दिष्ट करके भेजें
let response = await getAPIClient().sendMessage(
	"messenger", 	// messenger を指定したダイレクトメッセージを指定
	"Hello!",  	// 送信するメッセージ
	false,   	// 封書は off 
	["user1@xxx.com", "user2@xxx.com"]	// 宛先 Email アドレス 
	);
curl -H "x-cam-apiToken:token******" -d message="{\"panelName\":\"messenger\",\"message\":\"Hello\",\"isOpened\":false,\"generalPurposes\":{\"users\":\"user1@xxx.com,user2@xxx.com\"}}" ${serverURL}/sendMessage
चैट रूम निर्दिष्ट करें और भेजें
let response = await getAPIClient().sendMessage(
	"ルーム名", 
	"Hello!", 
	false,
        ["user1@xxx.com", "user2@xxx.com"]	// メンションとして Email アドレス指定 
);
curl -H "x-cam-apiToken:token******" -d message="{\"panelName\":\"ルーム名\",\"message\":\"Hello\",\"isOpened\":false,\"generalPurposes\":{\"users\":\"user1@xxx.com,user2@xxx.com\"}}" ${serverURL}/sendMessage

तर्क

भेजना
  • भेजने का लक्ष्य निर्दिष्ट करें
  • मैसेंजर के लिए, मैसेंजर निर्दिष्ट करें; चैट के लिए, कमरे का नाम निर्दिष्ट करें
उपयोगकर्ताओं
  • यदि भेजें मैसेंजर है, तो गंतव्य उपयोगकर्ता को। चैट रूम के मामले में, आपको पूरी बात साझा करने के बाद उल्लेख द्वारा सूचित किया जाएगा।
  • ईमेल पते द्वारा संबंधित उपयोगकर्ता को खोजें
  • एकाधिक ईमेल भेजते समय, ईमेल सीमांकक के रूप में निर्दिष्ट करें।
संदेश
  • भेजने के लिए संदेश निर्दिष्ट करें
  • यदि आप चाहते हैं कि टेक्स्ट एक नई लाइन पर टूट जाए, तो लाइन ब्रेक कोड \n डालें।
मुहर
  • सत्य/असत्य निर्दिष्ट करें. पढ़ने की रसीद के साथ भेजें

संदेश भेजो

JSON फ़ाइल से थोक में संदेश भेजें।

कृपया json फ़ाइल को कैरेक्टर कोड UTF8 में सहेजें।

नमूना

curl -H "x-cam-apiToken:token******" -d @messages.json ${serverURL}/sendMessages 
messages=[
 {"message":"こんにちは 1","property":{"users":"user1@test.com,user2@test.com"}},
 {"message":"こんにちは 2","property":{"users":"user1@test.com,user2@test.com"}},
 {"message":"こんにちは 3","property":{"users":"user1@test.com,user2@test.com"}},
 {"message":"こんにちは 4","property":{"users":"user1@test.com,user2@test.com"}},
]
messages=[
  {"send": "test", "message":"テスト 1"}
]

कॉल एपीआई

त्वरित कॉल बनाएं

त्वरित वेब सम्मेलन एक यूआरएल बनाएं.

नमूना

त्वरित मीटिंग URL बनाएं
let response = await getAPIClient().createQuickCall(
	1624368868714, 	// クイック会議の期限(UnixTimeミリ)
	"password!",  	// クイック会議のパスワードを指定
	);

तर्क

अवधि समाप्त तारीख
  • त्वरित बैठक के लिए समय सीमा निर्दिष्ट करें (यूनिक्सटाइम मिलीमीटर)
पासवर्ड
  • त्वरित मीटिंग पासवर्ड निर्दिष्ट करें
  • यदि खाली छोड़ दिया जाए तो बिना पासवर्ड वाला मीटिंग यूआरएल बन जाएगा।

उपयोगकर्ता एपीआई

उपयोगकर्ता API केवल कर्ल कमांड प्रदान करता है। इसे चलाने के लिए आपको प्रशासकीय विशेषाधिकारों की भी आवश्यकता होगी।

निर्यातउपयोगकर्ता

उपयोगकर्ता जानकारी CSV प्रारूप में पथ द्वारा निर्दिष्ट स्थान पर डाउनलोड की जाएगी।

नमूना

curl -H "x-cam-apiToken:token******" -d "path=exportUsers.csv" ${serverURL}/exportUsers

अपडेटयूजर्सCSV

CSV फ़ाइल से उपयोगकर्ता जानकारी को थोक में अपडेट करें. ※ संदर्भ सीएसवी प्रारूप

नमूना

curl -H "x-cam-apiToken:token******" -F "file=@updateUsers.csv" ${serverURL}/updateUsersCSV

चैटरूम एपीआई

अपडेटचैटरूम

चैट रूम बनाएं/अपडेट करें

नमूना

let chatRoom = { 
   "id":"1564831284702237059",
   "name":"秘密会議"
   "createUserId":"11u1pu9d32p8vuvjoZdd",
   "adminUserId":"11u1pu9d32p8vuvjoZdd",
   "isPublic":false,
   "memberUids":{ 
      "11u1pu9d32p8vuvjoZdd":true,
      "1lmn7hoh3s1ja26fsazw":true,
      "hhx10sfdv1jyou4la1ny":true,
      "3400w9rfvs504c35dt99":true,
      "309d32p8vuvjo5euuuwx":true
   },
}
let response = await getAPIClient().updateChatRoom(chatRoom);
let errors = response['errors'];
if (errors) {
	console.log(errors);
	return;
}
console.log(response["chatRoom"]);

तर्क

गपशप करने का कमरा
  • चैट रूम बनाने/अपडेट करने के लिए JSON
  • यदि नया है तो आईडी की आवश्यकता नहीं है

शेड्यूल एपीआई

getConferenceMaster

सम्मेलन कक्षों की मास्टर सूची प्राप्त करें।

नमूना

let response = await getAPIClient().getConferenceMaster();
let errors = response['errors'];
if (errors) {
	console.log(errors);
	return;
}
console.log(response["conferenceRooms"]);

तर्क

कोई नहीं

getConferenceRoomStatus

सम्मेलन कक्ष आरक्षण स्थिति की एक सूची प्राप्त करें

नमूना

let response = await getAPIClient().getConferenceRoomStatus("201908");
let errors = response['errors'];
if (errors) {
	console.log(errors);
	return;
}
console.log(response["conferenceRoomStatus"]);

तर्क

yyyyMMdd
  • यदि कोई तर्क निर्दिष्ट नहीं किया गया है, तो सम्मेलन कक्षों की एक मास्टर सूची प्राप्त की जाती है।
  • यदि आप तर्क yyyyMMdd में महीना या तारीख दर्ज करते हैं, तो आप संबंधित सम्मेलन कक्ष की आरक्षण स्थिति प्राप्त कर सकते हैं। उदाहरण) 201908 या 20190801
  • आरक्षणconferenceRooms.reservedSchedules में संग्रहीत किए जाते हैं।

API のエラー判定

API のエラー判定は、次の通り判定してください。

HTTPステータスが200以外

HTTPステータスが200以外の場合は、例外なくエラーです。

HTTPステータスが200だが、サーバでエラー

APIトークンが不正や、対象データが存在しない場合などは、HTTPステータスそのものは200で返却され、レスポンス中の status が 520 で判定可能です。また errors にはエラー原因の code と message が配列で格納されます。

{"status":520, "errors":[{"code":"805","message":"SC_INVALID_APITOKEN"}]}
  • URLをコピーしました!
विषयसूची