HRBC – FITSブログ https://blog.fits-inc.jp Webシステムの受託開発でお困りなら Tue, 07 Jul 2020 00:57:09 +0000 ja hourly 1 https://wordpress.org/?v=7.0.1 https://blog.fits-inc.jp/wp-content/uploads/2024/06/cropped-image-5-32x32.png HRBC – FITSブログ https://blog.fits-inc.jp 32 32 HRBC Resource API の ResultCode https://blog.fits-inc.jp/2020/04/01/hrbc-resource-api-%e3%81%ae-resultcode/ Wed, 01 Apr 2020 00:48:47 +0000 https://blog.fits-inc.jp/?p=382 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/

]]> HRBC Connect API を使ったアプリ開発の重要知識まとめ https://blog.fits-inc.jp/2019/04/05/hrbc-connect-api-%e3%82%92%e4%bd%bf%e3%81%a3%e3%81%9f%e3%82%a2%e3%83%97%e3%83%aa%e9%96%8b%e7%99%ba%e3%81%a7%e7%9f%a5%e3%81%a3%e3%81%a6%e3%81%8a%e3%81%8f%e3%81%b9%e3%81%8d%e3%81%93%e3%81%a8/ Fri, 05 Apr 2019 09:03:13 +0000 http://blog.fits-inc.jp/?p=42 　ポーターズ社の製品でHR-BusinessCloud（HRBC）という人材紹介・人材派遣のためのクラウドサービスが有ります。最近、お客様からのご依頼でこのHRBC 向けにAPI連携アプリを作成する機会に恵まれましたので、HRBC 向けにアプリを作る際の注意点をまとめました。

事前にHRBC API申込書の提出が必要

　アプリの開発には App ID、Secret といった情報が必要になりますが、これらの情報は HRBC の Redirect URL を記載した HRBC API 申込書をポーターズ社に提出する必要があります。App ID の発行までには5日程度見れば良いとのことです。（2019年4月現在）
　なお、ネットで検索すると第三者が公開しているHRBC Connect API 申込書のダウンロードページなどがありましたが、トラブルを避けるため、必ずポーターズ社の公式窓口に連絡するようにしてください。

月額料金が発生する

　HRBC Connect API を使用する場合は月額￥30,000（アクセス回数15万まで）の使用料が発生します。なお、超過1万単位毎に月額 2,000円が加算されます。

カスタムアプリの開発はユーザー企業が行う

　ポーターズ社はアプリの開発サービスは提供しておりません。メール配信自動化アプリや休眠スタッフ（求職者）掘り起しアプリなどは、自社の要望や仕様書を元にユーザー企業側が開発する必要があります。ただし、ポーターズ社の認定パートナーを紹介してもらうことも可能です。弊社も認定パートナーとなっており、システム開発の無料相談、無料見積を実施していますので是非ご検討ください。

APIベースでレスポンスはXML形式

　HRBC とのやりとりは WebAPI で行います。認証はOAuth2.0ベースですが、トークンは独自ヘッダに載せるので注意しましょう。また、レスポンスはXML形式なので、XMLの取扱が簡単な言語での開発をおすすめします。

データの削除はできない

　現時点ではAPIでデータの削除APIは提供されておらず、提供予定もないとのことなのでデータを削除する場合はRPAツールに連携するか、手動で消す必要があります。その他にもAPIを使用する上で様々な注意点がございます。（例えばAPIはUTCを前提に作られているので、日本のタイムゾーンで使用するためには9時間の時差を考慮する必要があるなど）

マーケティングオートメーションツールと連携が可能

　HRBC Connect API を正しく使用すれば、LINEとの連携や、MAツールと連携することでマッチングの精度を高めたり、求職者の行動を分析することでリード獲得やリード育成に役立てることができます。

HRBC API開発の認定パートナーをお探しなら

　HRBC APIを使用したシステムの構築、導入支援につきましてはポーターズ社の公式のパートナープログラムに登録済みである、弊社までお気軽にお問い合わせくださいませ。
　宮城、仙台に限らず、現地までお話を伺いに参ります。昨今の新型コロナウィルスの感染状況を鑑み、リモートでの対応も行っております。

]]>