滴滴企業(yè)開放平臺
專用API
【更新時間: 2024.07.11】
通過管理API接入,在內(nèi)部系統(tǒng)上進(jìn)行的人員管理等操作可以自動同步至企業(yè)版出行管理后臺。更方便地實現(xiàn)人員信息同步、制度查詢、訂單獲取、差旅權(quán)限同步的功能。
|
瀏覽次數(shù)
165
采購人數(shù)
0
試用次數(shù)
0
收藏
×
完成
取消
×
書簽名稱
確定
|
- API詳情
- 使用指南
- 常見 FAQ
- 關(guān)于我們
- 相關(guān)推薦
什么是滴滴企業(yè)開放平臺?
"滴滴企業(yè)開放平臺"是滴滴出行為企業(yè)提供的一站式出行管理和服務(wù)解決方案的開放平臺。該平臺通過API接口,允許企業(yè)將滴滴的企業(yè)版服務(wù)無縫集成到自身的內(nèi)部系統(tǒng)(如HR系統(tǒng)、報銷系統(tǒng)、OA系統(tǒng)等)或第三方平臺(如商旅平臺、費控平臺等),實現(xiàn)出行服務(wù)的集中管理和高效運作。
滴滴企業(yè)開放平臺有哪些核心功能?
第三方平臺對接 |
|||
|
支持在所有產(chǎn)品中接入滴滴企業(yè)版服務(wù),與滴滴共享一站式出行資源及多樣化出行管理方案,豐富您的產(chǎn)品功能與業(yè)務(wù)范圍,共同探索高效獲客新模式。在第三方平臺上實現(xiàn)滴滴企業(yè)版功能,同時支持企業(yè)支付與個人支付(需報銷)兩種模式,后者可在不改變企業(yè)原有報銷模式情況下提供同等出行管理、數(shù)據(jù)歸集、統(tǒng)一開票服務(wù)
|
|||
|
費控類平臺 |
商旅類平臺 |
消費類平臺 |
主流平臺 |
企業(yè)內(nèi)部系統(tǒng)對接 |
|||
|
|
支持所有企業(yè)在自有平臺接入滴滴企業(yè)版,用一套系統(tǒng)進(jìn)行人員出行管理,為您的系統(tǒng)提供基于企業(yè)版管理能力上更高效便捷的升級拓展方案。通過管理API接入,在內(nèi)部系統(tǒng)上進(jìn)行的人員管理等操作可以自動同步至企業(yè)版出行管理后臺。更方便地實現(xiàn)人員信息同步、制度查詢、訂單獲取、差旅權(quán)限同步的功能。
|
||
|
HR系統(tǒng) |
報銷系統(tǒng) |
OA系統(tǒng) |
內(nèi)部系統(tǒng) |
管理API您可通過管理API將第三方系統(tǒng)與滴滴企業(yè)版管理后臺打通,直接在第三方系統(tǒng)實現(xiàn)人 員維護(hù)、報銷對賬、用車審批等功能,操作后將自動同步至企業(yè)版。簡化操作流程 整臺系統(tǒng)資源 |
|||
滴滴企業(yè)開放平臺的核心優(yōu)勢是什么?
- 一站式出行資源:合作伙伴可以利用滴滴的出行資源,提升服務(wù)水平。
- 多樣化出行管理方案:提供靈活的支付和管理方案,滿足不同企業(yè)需求。
- 系統(tǒng)整合與自動化:通過管理API實現(xiàn)系統(tǒng)資源的整合和自動化操作,提高效率。
在哪些場景會用到滴滴企業(yè)開放平臺?
|
企業(yè)內(nèi)部系統(tǒng)對接 如HR系統(tǒng)、報銷系統(tǒng)、OA系統(tǒng)等,實現(xiàn)人員信息、差旅權(quán)限、訂單數(shù)據(jù)等的自動同步。 |
|
|
第三方平臺接入 如商旅平臺、費控平臺等,提供一站式出行服務(wù),豐富平臺功能和業(yè)務(wù)范圍。 |
|
|
企業(yè)出行管理 適用于各類需要集中管理員工出行的企業(yè),如互聯(lián)網(wǎng)公司、金融機(jī)構(gòu)、制造業(yè)企業(yè)等。 |
1. 賬號申請
接入方在調(diào)用我們接口需要client_id、client_secret、phone、company_id等一些通用的接入方賬號信息,這些信息可在我們官網(wǎng)創(chuàng)建正式應(yīng)用后獲得。 創(chuàng)建正式應(yīng)用的步驟請參照申請測試應(yīng)用步驟。
注意:
- 管理API沒有測試應(yīng)用的賬號!請您一定要創(chuàng)建正式應(yīng)用以獲取賬號信息!切記!
- 創(chuàng)建的應(yīng)用需要等待3個工作日完成審核,完成審核之后方可調(diào)用接口,請耐心等待。
2. 接入步驟
申請到賬號后,我們用賬號中的client_id、client_secret等信息調(diào)用的第一個接口授權(quán)認(rèn)證,通過該接口的返回值access_token,我們才可以調(diào)用其他接口。
access_token緩存方案
除了授權(quán)接口之外,我們所有接口都需要access_token這個參數(shù),access_token的獲取方式見[授權(quán)認(rèn)證接口](../oauth/auth.md);該接口返回的access_token有效期為30分鐘,在未過期之前接入方可以使用這個token
調(diào)用所有接口,所以建議將返回的授權(quán)信息緩存30分鐘(緩存過期或調(diào)用服務(wù)時返回401=>access_token不合法或已過期,再重新申請授權(quán)),不要每次調(diào)用接口都申請一次授權(quán)。
3. 測試工具
簽名驗證工具,用于驗證接口報19999簽名驗證失敗的工具
返回值解析工具,如返回值進(jìn)行了Unicode編碼{"errno":51102,"errmsg":"\u4e0d\u6ee1\u8db3\u5f00\u7968\u8981\u6c42","data":null}
時間戳計算工具,用于計算當(dāng)前時間戳和通過時間戳反解出年月日格式的時間
縣市級城市查詢工具,用于確認(rèn)一個城市是否為地級市
4. 問題反饋方式
權(quán)限問題
如開通賬號,申請測試應(yīng)用,接口調(diào)用權(quán)限等,請聯(lián)系對接的滴滴商務(wù)同學(xué)給您們開通相應(yīng)的接口使用權(quán)限
接口調(diào)用出錯問題
- 首先查詢常見錯誤解決方案文檔嘗試解決問題;
- 如果文檔中沒有解決方案,請在對接群咨詢我們的銷售同學(xué);
- 如果銷售同學(xué)無法解決,請按照以下模板提供相應(yīng)的信息咨詢我們的客服同學(xué)
問題描述(必填) request_id(必填) 返回值(必填) 請求時間 請求url
5. 基本要求
- 請接入方務(wù)必在日志中記錄調(diào)用接口的請求參數(shù)、返回值,尤其是返回值中的request_id,方便問題排查;
- 請接入方在調(diào)用接口時嚴(yán)格遵守接口規(guī)范,包括請求方式(如GET或POST)、請求格式(如JSON)、請求參數(shù)格式(如JSON串或object對象或數(shù)組)等。
- 為提升傳輸安全性,滴滴企業(yè)版將在2023年6月進(jìn)行OpenAPI的 TLS 版本升級變更操作,升級后 TLS 1.0及 1.1 版本請求將無法連接,僅支持 TLS1.2 及以上版本的客戶端發(fā)起請求;新接入客戶請確保TLS版本為1.2及以上。
指南詳情鏈接:https://open.es.xiaojukeji.com/doc/erpapi/introduction/mustRead.html
滴滴企業(yè)版,為企業(yè)提供一站式出行與商旅管理解決方案的行業(yè)先行者
在大大改善員工出行、商旅、報銷體驗的同時,確保員工出行符合企業(yè)規(guī)定,減少違規(guī)風(fēng)險,降低出行成本,全面提升企業(yè)管理效率。
出行服務(wù)已開通超過400個城市,覆蓋加班、商務(wù)出行、定點通勤、接送機(jī)等10大場景;
商旅服務(wù)已覆蓋全國主要差旅城市,與全國超過50萬家酒店合作,覆蓋國內(nèi)航司/航線和鐵路車次;
1. 賬號申請
接入方在調(diào)用我們接口需要client_id、client_secret、phone、company_id等一些通用的接入方賬號信息,這些信息可在我們官網(wǎng)創(chuàng)建正式應(yīng)用后獲得。 創(chuàng)建正式應(yīng)用的步驟請參照申請測試應(yīng)用步驟。
注意:
- 管理API沒有測試應(yīng)用的賬號!請您一定要創(chuàng)建正式應(yīng)用以獲取賬號信息!切記!
- 創(chuàng)建的應(yīng)用需要等待3個工作日完成審核,完成審核之后方可調(diào)用接口,請耐心等待。
2. 接入步驟
申請到賬號后,我們用賬號中的client_id、client_secret等信息調(diào)用的第一個接口授權(quán)認(rèn)證,通過該接口的返回值access_token,我們才可以調(diào)用其他接口。
access_token緩存方案
除了授權(quán)接口之外,我們所有接口都需要access_token這個參數(shù),access_token的獲取方式見[授權(quán)認(rèn)證接口](../oauth/auth.md);該接口返回的access_token有效期為30分鐘,在未過期之前接入方可以使用這個token
調(diào)用所有接口,所以建議將返回的授權(quán)信息緩存30分鐘(緩存過期或調(diào)用服務(wù)時返回401=>access_token不合法或已過期,再重新申請授權(quán)),不要每次調(diào)用接口都申請一次授權(quán)。
3. 測試工具
簽名驗證工具,用于驗證接口報19999簽名驗證失敗的工具
返回值解析工具,如返回值進(jìn)行了Unicode編碼{"errno":51102,"errmsg":"\u4e0d\u6ee1\u8db3\u5f00\u7968\u8981\u6c42","data":null}
時間戳計算工具,用于計算當(dāng)前時間戳和通過時間戳反解出年月日格式的時間
縣市級城市查詢工具,用于確認(rèn)一個城市是否為地級市
4. 問題反饋方式
權(quán)限問題
如開通賬號,申請測試應(yīng)用,接口調(diào)用權(quán)限等,請聯(lián)系對接的滴滴商務(wù)同學(xué)給您們開通相應(yīng)的接口使用權(quán)限
接口調(diào)用出錯問題
- 首先查詢常見錯誤解決方案文檔嘗試解決問題;
- 如果文檔中沒有解決方案,請在對接群咨詢我們的銷售同學(xué);
- 如果銷售同學(xué)無法解決,請按照以下模板提供相應(yīng)的信息咨詢我們的客服同學(xué)
問題描述(必填) request_id(必填) 返回值(必填) 請求時間 請求url
5. 基本要求
- 請接入方務(wù)必在日志中記錄調(diào)用接口的請求參數(shù)、返回值,尤其是返回值中的request_id,方便問題排查;
- 請接入方在調(diào)用接口時嚴(yán)格遵守接口規(guī)范,包括請求方式(如GET或POST)、請求格式(如JSON)、請求參數(shù)格式(如JSON串或object對象或數(shù)組)等。
- 為提升傳輸安全性,滴滴企業(yè)版將在2023年6月進(jìn)行OpenAPI的 TLS 版本升級變更操作,升級后 TLS 1.0及 1.1 版本請求將無法連接,僅支持 TLS1.2 及以上版本的客戶端發(fā)起請求;新接入客戶請確保TLS版本為1.2及以上。
指南詳情鏈接:https://open.es.xiaojukeji.com/doc/erpapi/introduction/mustRead.html
滴滴企業(yè)版,為企業(yè)提供一站式出行與商旅管理解決方案的行業(yè)先行者
在大大改善員工出行、商旅、報銷體驗的同時,確保員工出行符合企業(yè)規(guī)定,減少違規(guī)風(fēng)險,降低出行成本,全面提升企業(yè)管理效率。
出行服務(wù)已開通超過400個城市,覆蓋加班、商務(wù)出行、定點通勤、接送機(jī)等10大場景;
商旅服務(wù)已覆蓋全國主要差旅城市,與全國超過50萬家酒店合作,覆蓋國內(nèi)航司/航線和鐵路車次;