← 応募者管理Talent Flow

応募者情報の取得API

Talent Flowに取り込んだ応募者情報を、許可した接続先から読み取るための連携キーを管理します。応募者の登録・編集・削除はできません。移行元システムのAPI形式・既存の接続先との互換性は未検証です。

キーを発行すると、選んだ利用者の閲覧範囲と、ここで指定した支店・項目の範囲内を取得できます。許可IPと有効期限を指定してください。利用者の停止・パスワード変更後は、古いキーを使えません。ログアウトだけではキーは失効しません。

登録済みの連携

接続方法と取得できる範囲

読み取り専用のGETリクエストを使用します。連携キーはURLに入れず、Authorizationヘッダーで送信します。

1ページ50件まで返します。次のページがある場合、応答の next の値を after に指定します。応募者ID1件を指定する場合は id を使います。利用者の閲覧権限・非表示項目は取得時にも確認します。
検索条件：search（氏名・かな・企業・仕事No）、provider（媒体コード）、source（管理先）、owner（担当）、status（進捗）。検索に使う項目が取得範囲に含まれていない場合は拒否します。出力はTalent FlowのJSON形式です。元CSV・対応履歴・添付ファイル・独自管理項目は含めません。
同じキーで1分120回まで取得できます。超過時は429で応答し、次の分に再試行できます。読み取り時の利用回数を記録します。応募者データやスプレッドシート・移行元システム・各媒体の情報は変更しません。