データタイプとファイル処理

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	郵便番号
country	CountryCode	ISO国コード

職務情報

職務情報

フィールド	タイプ	説明
workExperience	Object	職歴
education	Objectのリスト	学歴
skills	Objectのリスト	技術的スキルおよびソフトスキル
certifications	Objectのリスト	専門的な免許および資格

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

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

タイプ	列挙値	説明	処理
メインの履歴書	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：ファイル内容のBase64エンコードされたMD5ハッシュ。

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

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分超）。	応募を再初期化します。

エラー処理

応募の処理エラー

送信後、応募で処理エラーが発生する可能性があります。

type AtsSyncCandidateSyncApplicationVersionStatus {
  # ... other fields ...
  processingStatus: AtsSyncCandidateSyncApplicationProcessingStatusType
  errors: [AtsSyncCandidateSyncApplicationErrorType!]
}

送信した応募の問題を特定して解決するため、processingStatusとerrorsフィールドを監視します。

一般的な連携エラー

一般的な連携エラー

シナリオ	エラー	解決方法
無効なパートナーアプリ	パートナーアプリの設定が無効です。Indeedにお問い合わせください。	Indeedのパートナー担当者にお問い合わせください。
無効な登録ID	指定された雇用主登録が存在しません。	登録IDが正しいことを確認してください。Employer Registration APIガイドをご覧ください。
雇用主が機能を有効化していない	雇用主登録で応募の送信機能が有効になっていません。	Employer Registration APIガイドを使用して雇用主の機能を更新してください。
GraphQLバリデーション	必須フィールドが不足しています。	スキーマの要件を確認します。
大容量の応募ファイル	すべての添付ファイルの合計サイズは15 MBを超えてはなりません。	必須でない大きなファイルを除外します。
応募ファイルの重複	添付ファイルを重複させてはなりません。	重複したファイルを除外します。
履歴書の複数指定	履歴書は1つのみ含めてください。	重複した履歴書を除外します。
カバーレターの複数指定	カバーレターは1つのみ含めてください。	重複したカバーレターを除外します。
削除済みの応募の公開	応募はすでに削除されています。	削除済みの応募を再初期化または送信しないでください。

 

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