隨著最近向遠程、隨處工作模式的遷移,全球職位列表網(wǎng)站正變得越來越流行。但是,您的工作現(xiàn)場或求職者跟蹤系統(tǒng)如何幫助雇主采取下一步措施,讓求職者在其居住國被雇用和入職?輸入遠程 API!
借助遠程 API,雇主無需離開您的平臺,即可完成 60 多個國家/地區(qū)成功求職者的招聘流程。在本博客系列中,我們將提供使用遠程 API 可以實現(xiàn)的不同級別的載入集成的示例。
本系列從這篇文章開始,我們提供了基本集成的說明,允許雇主通過單擊平臺中的按鈕來啟動員工入職,從而使招聘過程更快,更順暢。本系列中的后續(xù)文章將為您提供構(gòu)建塊,以創(chuàng)建更深入的員工入職集成。
有了這個,讓我們學(xué)習(xí)如何啟動與遠程API的集成!
開發(fā)輕量級集成
要啟動能夠改善客戶生活并需要最少開發(fā)工作的集成,或者如果您只想在進行更深入的集成之前衡量客戶興趣,我們建議您從輕量級方法開始。
在與 Remote 的輕量級集成中,雇主可以選擇他們想要在您的平臺上雇用的候選人。只需單擊一個按鈕,他們就會被重定向到遠程,在那里他們看到候選人已添加到我們的系統(tǒng)中,并準備開始國際入職流程。從這里開始,雇主只需添加一些合同詳細信息,以便Remitary可以生成就業(yè)協(xié)議,邀請新員工添加其個人詳細信息。Remote 負責(zé)其余的工作,以確保新員工在其所在國家/地區(qū)合規(guī)地被雇用,注冊福利并設(shè)置工資單。
先決條件
重要的是要注意,這種輕量級集成有幾個先決條件:
- 客戶必須已經(jīng)是遠程客戶。如果不是,他們可以輕松快速地在線創(chuàng)建遠程帳戶?;蛘撸愕膱F隊可以詢問我們有關(guān)使用“創(chuàng)建公司”終結(jié)點的信息,該終結(jié)點允許你為客戶創(chuàng)建新的遠程帳戶。
- 用戶必須已經(jīng)是遠程用戶。如果不是,他們可以要求其遠程公司管理員將其添加到公司的遠程帳戶。或者,您的團隊可以詢問有關(guān)我們的公司經(jīng)理終結(jié)點的信息,您可以使用該終結(jié)點在遠程模式下為這些情況創(chuàng)建公司經(jīng)理帳戶。
先決條件
重要的是要注意,這種輕量級集成有幾個先決條件:
- 客戶必須已經(jīng)是遠程客戶。如果不是,他們可以輕松快速地在線創(chuàng)建遠程帳戶?;蛘?,你的團隊可以詢問我們有關(guān)使用“創(chuàng)建公司”終結(jié)點的信息,該終結(jié)點允許你為客戶創(chuàng)建新的遠程帳戶。
- 用戶必須已經(jīng)是遠程用戶。如果不是,他們可以要求其遠程公司管理員將其添加到公司的遠程帳戶?;蛘?,您的團隊可以詢問有關(guān)我們的公司經(jīng)理終結(jié)點的信息,您可以使用該終結(jié)點在遠程模式下為這些情況創(chuàng)建公司經(jīng)理帳戶。
注冊成為 API 合作伙伴
當(dāng)您注冊為 API 合作伙伴時,Remote 將:
- 與您聯(lián)系,討論如何將全球就業(yè)解決方案直接嵌入您的平臺并批準您的申請。
- 讓您能夠訪問我們詳細的 API 文檔。
- 使用客戶端憑據(jù)設(shè)置以訪問遠程 API。
- 提供對演示環(huán)境的訪問權(quán)限,以便您可以測試集成。
- 在 Remote 中創(chuàng)建集成實體,以便使用您的集成的任何公司都鏈接到您的實體,并且您將能夠讀取和管理這些客戶的數(shù)據(jù)。
- 在 Remote 的 UI 中突出顯示您的 API 集成,以共享有關(guān)您公司的信息以及入門說明,供所有客戶查看。這對您的公司來說是一個很大的可見性,因為遠程的所有客戶都會在這里看到您,無論他們是否已經(jīng)注冊了您的服務(wù)!
準備好立即開始成為 API 合作伙伴的旅程了嗎?立即注冊Remote以了解更多信息!
構(gòu)建許可流
Remote 已實施 OAuth 2 授權(quán)代碼流,因此我們的客戶可以同意 API 集成合作伙伴訪問和管理其在 Remote 中的資源。當(dāng)新用戶首次嘗試使用您的 API 集成時,他們將看到集成可以執(zhí)行的操作,并被要求提供同意。通過集成執(zhí)行的所有操作都是代表登錄用戶執(zhí)行的。
遠程將與您的團隊合作,為您的集成實施正確的許可流。實現(xiàn)許可流后,集成的新用戶的流將如下所示:
- 用戶嘗試在您的平臺中執(zhí)行需要集成的操作(例如,單擊使用 Remote 的 EOR 服務(wù)雇用新候選人的選項)。
- 應(yīng)用程序?qū)⒂脩糁囟ㄏ虻?nbsp;Remote 的授權(quán)頁。
- 如果用戶已登錄,則會將他們直接發(fā)送到 Remote 的授權(quán)頁面。如果用戶當(dāng)前未登錄到 Remote,我們會將他們重定向到登錄頁面,并在其中輸入其 Remote 用戶名和密碼,并重定向到 Remote 的授權(quán)頁面。快速提示:您可以使用 /v1/sso-url 跳過用戶登錄要求,這將為用戶創(chuàng)建一個活動會話。
- 在授權(quán)頁面上,用戶可以看到集成希望代表他們執(zhí)行的操作,并可以選擇是允許還是拒絕訪問。
- 用戶完成許可流后,將使用您提供給 Remote 的回調(diào) URL 將他們重定向回您的應(yīng)用程序。
- 當(dāng)用戶被重定向回您的應(yīng)用程序時,您將在 URL 的查詢字符串中收到授權(quán)代碼。您可以交換授權(quán)代碼以獲取刷新令牌和有效的訪問令牌。
- 應(yīng)用程序?qū)⒃谑跈?quán)標頭中傳遞訪問令牌,以供將來代表用戶執(zhí)行操作的 API 請求使用。
- 在第一個公司用戶啟用集成后,該公司的所有管理員用戶都可以在遠程 UI 中看到已啟用集成。他們還可以看到其公司中已同意集成的用戶列表。
- 在遠程 UI 中,管理員用戶還可以為其公司禁用集成或刪除特定用戶對集成的訪問權(quán)限。
遠程 API 文檔中提供了有關(guān)實現(xiàn)授權(quán)代碼流的詳細說明和代碼示例。
將新員工的基本詳細信息發(fā)送到遠程,并將用戶重定向到遠程平臺
當(dāng)您平臺中的用戶表示他們希望繼續(xù)招聘應(yīng)聘者時,您可以將應(yīng)聘者的詳細信息發(fā)送到 Remote,同時將用戶重定向到 Remote 的平臺,在那里他們將看到新員工的個人資料,并將新員工移動到入職流程的下一階段。
要將應(yīng)聘者的詳細信息發(fā)送到 Remote,請向 POST /v1/employment 發(fā)送請求,其中包含以下必需的詳細信息:
- company_id:客戶的遠程 ID。此值在刷新令牌響應(yīng)中返回。它不會改變,所以請隨時存儲它以備將來參考。您還可以通過向 GET /v1/companies 發(fā)出請求來獲取公司 ID。
- country_code:候選人將被雇用的國家/地區(qū)。在撰寫本文時,Remote支持在60多個國家/地區(qū)(并且正在快速增長)招聘。如果用戶嘗試在不受支持的國家/地區(qū)招聘,您將收到來自 API 的錯誤響應(yīng),并可以使用它來提醒您的用戶。
- 候選人的full_name、job_title、personal_email和provisional_start_date。這些詳細信息將用于在 Remote 和應(yīng)聘者之間代表客戶創(chuàng)建雇傭協(xié)議。

當(dāng)遠程收到 POST 請求時,將創(chuàng)建新的雇用記錄。新員工將顯示在 Remote 的“入職”頁面中。
將用戶重定向到遠程的載入頁面,以便他們可以完成添加遠程所需的任何其他詳細信息,并邀請員工在遠程中完成載入。在將用戶登錄重定向到“載入”頁面時,有兩個選項可用于處理用戶登錄:
- 將用戶重定向到 Remote 的登錄頁面,他們可以在其中輸入用戶名和密碼或使用 SSO 登錄。如果他們已經(jīng)在 Remote 中有一個活動會話,他們將繞過登錄頁面。
- 使用 GET /v1/sso_url 獲取用戶的重定向 URL 并繞過登錄頁。選擇此選項時,可以傳遞以下參數(shù):
- user_id:遠程中的用戶 ID。此值在刷新令牌響應(yīng)中返回。它不會改變,所以請隨時存儲它以備將來參考。還可以通過向 GET /v1/公司經(jīng)理發(fā)出請求并與用戶的電子郵件地址進行匹配來獲取用戶的 ID。
- action=redirect_to_onboarding&user_id=<user_id>:將用戶重定向到其公司的載入頁面
就是這樣!現(xiàn)在,您可以與 Remote 進行令人愉快的集成,無論求職者身在何處,它都能幫助您的客戶更快地實現(xiàn)其招聘目標!
請求訪問遠程 API 并立即開始構(gòu)建!
希望本指南能激發(fā)出有關(guān)如何使用遠程 API 解決客戶首要難題的新想法。我們只是觸及了如何使用API構(gòu)建簡化的客戶流的表面。請繼續(xù)關(guān)注本系列中的更多內(nèi)容,我們將在其中更深入地了解我們的API功能,并探索與Remitude構(gòu)建全面API集成的其他可能性!
在 Remote,我們相信一起學(xué)習(xí),傾聽開發(fā)人員社區(qū)的反饋,并根據(jù)收到的反饋不斷改進。我們的遠程 API 現(xiàn)已推出,因此請立即請求訪問我們的開發(fā)人員文檔并分享您的反饋!