WiseCRM365 OpenAPI 簡介

簡介

WiseCRM365 OpenAPI 是基于 WiseCRM365 的服務接口?？蛻敉ㄟ^接入和集成 OpenAPI 可以方便、高效地對相關業(yè)務或數(shù)據(jù)進行處理，與其他系統(tǒng)進行業(yè)務交互。WiseCRM365 OpenAPI 為已經(jīng)開通了 OpenAPI 模塊的企業(yè)用戶提供服務。

基本調(diào)用規(guī)則

本文檔中列出的所有 API 基礎調(diào)用 URL 是 https://www.365.wisecrm.com/gw/ （特別指明的除外）,如 API user/login-token 實際請求 URL 為 https://www.365.wisecrm.com/gw/user/login-token 。WiseCRM365 OpenAPI 目前支持 JSON 格式數(shù)據(jù)，后期將提供 XML 格式數(shù)據(jù)支持。

OpenAPI URL 規(guī)則：https://www.365.wisecrm.com/gw/[model]/[function]

通常，對于業(yè)務數(shù)據(jù)的操作主要包含新建、查詢（單記錄查詢、列表查詢）、更新、刪除，其對應的 [function] 如下

操作	[function]	示例
新建	add	account/add 新建客戶
獲取單條記錄	get	account/get 查詢單條客戶記錄
查詢列表	list	account/list 查詢客戶列表
修改	update	account/update 修改客戶資料
刪除	delete	account/delete 刪除客戶

RESTful API

WiseCRM365 OpenAPI 采用了 RESTful API 風格，它提供了 HTTP 的請求規(guī)范，多數(shù)的 API 需采用 POST 方式發(fā)送請求，少量的服務類 API 使用 GET 方式獲取數(shù)據(jù)。請注意，除 API 列舉的請求方式外，其他方法都不被支持。

WiseCRM365 OpenAPI 遵循統(tǒng)一的數(shù)據(jù)返回格式，例如：

{ "error_code":0, "error_msg":"調(diào)用成功", "data":xxx }

其中 data 為回傳的數(shù)據(jù)，error_code 為錯誤碼，error_msg 為錯誤描述，當 error_code 值為 0 時表示調(diào)用成功，其他值表示失敗?？傮w上可分為以下幾類錯誤碼：

• 0 請求成功
• 4XX 請求失敗（例如提供了不恰當?shù)膮?shù)，具體出錯原因，會在 error_msg 中標注原因）
• 5XX 服務器錯誤（出現(xiàn)此錯誤，請聯(lián)系服務人員）

詳情參見 全局錯誤碼說明