HRBC Resource API の ResultCode

by .

Resource API と Authentication API

　HRBC Connect API(HRBC API) には大別して2種類のAPIが存在します。Resource API と Authentication API です。Authentication API は Resource API を呼び出すためのトークンを取得するための認証APIで、使用するためには契約時にはこうされる Redirect URL や、アプリ登録により発行されるApp ID、Secret が必要となります。Resource API はマスタ情報や、HRBC に登録されている各種データを取得（更新も）できます。

Resource API で取得できるもの

　HRBC の内部では起業ごとのデータをPartition（CompanyDBとも呼ぶ）と呼ばれる単位で管理しています。このPartitionに格納されている実際のデータがResourceです。例えば「個人の連絡先」に対応するResource は Candidateですし、JOB（職種）に関するデータであれば、Job Resource といった具合に存在しています。HRBC APIで取得できる代表的な Resource には Client、Recruiter、Job、Candidate、Resume、Process、Activity、Contract、Sales、Phase、Attachment などがあります。

Resource API で返却される Code とは？

　HRBCのAPIを使用していると、下記のようなCodeのみのレスポンスが返ってくることがあります。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<System>
    <Code>401</Code>
</System>

これはいわゆるエラーレスポンスであり Code の値によってエラー原因が推測できます。Code の値とエラー原因は下記の公式サイトから確認可能です。

https://hrbcapi.porters.jp/hc/ja/articles/115008171708-Result-Code-List

Codeエラー内容
5ユーザーIDが無効です
6アクセスしているユーザーに権限がありません。
7指定されたResourceは存在しません。
8システムの内部エラーが発生しました。
9システムが一時的に利用できない状態になっています。
100指定されたパラメータが無効です。
101必要なパラメータが不足しています。
102パラメータが多すぎます。
103指定されたパラメータの値が無効です。

HRBC の API を使ったシステムを開発可能なベンダーをお探しなら

　宮城、仙台に限らず、HRBC の API を使ったシステム導入にお困りの方や、システムの見積りや構築が可能なベンダーをお探しの方がいらっしゃいましたら、ぜひ弊社までご相談ください。

宮城県仙台市のシステム開発会社FITS
https://www.fits-inc.jp/