データ型とファイル処理

Send Candidates APIのデータ型、ファイル添付、アップロード要件。

 

法的注意

By using this API and its documentation and building an integration, you agree to the Additional API Terms and Guidelines.

データ型

応募者の詳細

applicantオブジェクトには、候補者に関する包括的な情報が含まれます。

必須フィールド

応募者の必須フィールド

フィールド	タイプ	説明
name	String	応募者の氏名
email	EmailAddress	連絡先となる有効なメールアドレス

所在地情報

所在地情報

フィールド	タイプ	説明
streetAddress	String	ジオロケーション用の完全な住所
postalCode	String	郵便番号／ZIPコード
country	CountryCode	ISO国コード

職務情報

職務情報

フィールド	タイプ	説明
workExperience	Object	職歴
education	Objectのリスト	学歴
skills	Objectのリスト	テクニカルスキルおよびソフトスキル
certifications	Objectのリスト	業務上のライセンスおよび資格

対応する添付ファイルのタイプ

対応する添付ファイルのタイプ

タイプ	Enum値	説明	処理
メインの履歴書	RESUME	メインの履歴書ドキュメント	マッチングとランキングのために解析
追加の履歴書	OTHER_RESUME	サブの履歴書	保存のみ、解析なし
メインのカバーレター	COVER_LETTER	メインのカバーレタードキュメント	保存
追加のカバーレター	OTHER_COVER_LETTER	サブのカバーレター	保存
その他	OTHER	その他の補足書類	保存

重要な注意事項

• 1件の応募につき、タイプRESUMEの添付ファイルは1つだけ指定できます。候補者マッチングのために解析されます。
• 1件の応募につき、タイプCOVER_LETTERの添付ファイルは1つだけ指定できます。

ファイルアップロード要件

事前署名済みURLの制約

S3の事前署名済みURLのバリデーションに基づき、アップロードは次の厳格な要件を満たす必要があります。

必須ヘッダー

1. Content-Type：初期化時に宣言した値と完全に一致する必要があります。
2. Content-Length：宣言したサイズ（バイト数）と一致する必要があります。
3. Content-MD5：ファイル内容のMD5ハッシュをBase64でエンコードした値。

アップロードリクエストの例

curl -X PUT \
  "https://s3.amazonaws.com/..." \
  -H "Content-Type: application/pdf" \
  -H "Content-Length: 245123" \
  -H "Content-MD5: rL0Y20zC+Fzt72VPzMSk2A==" \
  --data-binary @resume.pdf

MD5チェックサムの計算

JavaScript/Node.js：

const crypto = require('crypto');
const fs = require('fs');

function calculateMD5(filePath) {
  const fileBuffer = fs.readFileSync(filePath);
  const hash = crypto.createHash('md5');
  hash.update(fileBuffer);
  return hash.digest('base64');
}

Python：

import hashlib
import base64

def calculate_md5(file_path):
    with open(file_path, 'rb') as f:
        file_content = f.read()
    return base64.b64encode(
        hashlib.md5(file_content).digest()
    ).decode('ascii')

アップロードのバリデーション

S3はバリデーションに失敗したアップロードを次のエラーコードで拒否します。

アップロードのバリデーション

エラーコード	原因	解決方法
SignatureDoesNotMatch	ヘッダーまたはコンテンツが欠落または不正です。	すべてのヘッダーが初期化時の値と一致していることを確認します。
BadDigest	ファイル内容がMD5と一致しません。	ファイルの整合性とチェックサムの計算を確認します。
AccessDenied	URLが期限切れ（5分超）です。	応募を再初期化します。

エラー処理

よくあるエラーには、S3アップロードのバリデーション失敗、パートナーアプリの設定上の問題、雇用主登録のエラー、添付ファイルの制約に関するエラーなどがあります。

詳細なエラーの説明と解決手順については、Send Candidates APIエラーのトラブルシューティングをご覧ください。

 

このページは役に立ちましたか？