Job Sync APIエラーのトラブルシューティング

一般的なJob Sync APIエラーとその解決方法。

 

エラーの検出方法

Job Sync APIは以下の方法でエラーを返します：

• HTTPステータスコード - レート制限（HTTP 429）とネットワークレベルの障害のみ
• GraphQLエラー配列 - ほとんどのエラーはHTTP 200で、レスポンスボディにエラー詳細を含めて返します

HTTP 200の場合でも、常にレスポンスボディのerrors配列を確認してください：

{
  "data": null,
  "errors": [{
    "message": "Error description",
    "extensions": {
      "code": "BAD_USER_INPUT",
      "classification": "ValidationError"
    }
  }]
}

extensions.codeフィールドにはエラータイプ（FORBIDDEN、BAD_USER_INPUT、GRAPHQL_PARSE_FAILEDなど）が含まれます。

FORBIDDENエラー

FORBIDDENエラー

message	Client is not authorized
code	FORBIDDEN
概要	アクセストークンがない、無効、期限切れ、または必要な権限がありません。

FORBIDDENコードのClient is not authorized messageは、OAuthクライアントにJob Sync API認可がないことを意味します：

{
  "data": null,
  "errors": [{
    "extensions": {
      "code": "FORBIDDEN"
    },
    "message": "Client is not authorized."
  }]
}

解決方法：

1. Authorizationヘッダーの形式を確認：Authorization: Bearer <YOUR_ACCESS_TOKEN>
2. トークンが期限切れでないことを確認（1時間有効）。
3. Indeed担当者に連絡してAPIアクセスを確認。
4. OAuthアプリケーションにJob Sync API権限があることを確認。
5. sourceNameが登録済みフィードと一致することを確認。

OAuthトークンエラーについては、OAuthエラーのトラブルシューティングを参照してください。

BAD_USER_INPUTエラー

BAD_USER_INPUTエラー

message	Exception while fetching data
code	BAD_USER_INPUT
概要	クライアントが無効なデータを送信しました。

BAD_USER_INPUT検証エラーは、リクエストに無効なデータが含まれている場合に発生します。

無効な電話番号の例：

{
  "errors": [{
    "extensions": {
      "code": "BAD_USER_INPUT",
      "classification": "ValidationError"
    },
    "message": "Validation error (WrongType@[jobsIngest/createSourcedJobPostings]) : argument 'input.jobPostings[0].metadata.contacts[0].contactInfo.contactPhone' with value 'StringValue{value='5551234567'}' is not a valid 'PhoneNumber' - String value `5551234567` is not a valid E.164 phone number"
  }]
}

BAD_USER_INPUTエラーの一般的な原因：

必須フィールドの欠落

エラーメッセージは、どのフィールドが欠落しているかを示します。必須フィールドには以下が含まれます：

必須フィールドの欠落エラー

セクション	必須フィールド
body	title、description、benefits（空配列可）、location.country
metadata	jobPostingId、jobSource.sourceName、datePublished、contacts（少なくとも1つ）

無効な日時

DateTime値は、タイムゾーン付きのRFC 3339形式を使用する必要があります：

無効な日時

形式	有効？
2024-01-15T10:30:00-05:00	はい
2024-01-15T15:30:00Z	はい
2024-01-15	いいえ（時刻がない）
01/15/2024 10:30	いいえ（形式が間違っている）

無効な国コード

国コードはISO-3166-1 alpha-2形式（大文字2文字）を使用する必要があります：

無効な国コード

形式	有効？
US	はい
USA	いいえ（2文字コードを使用）
us	いいえ（大文字にする必要あり）

無効な通貨コード

通貨コードはISO-4217形式（大文字3文字）を使用する必要があります：

無効な通貨コード

形式	有効？
USD	はい
$	いいえ（ISOコードを使用）
usd	いいえ（大文字にする必要あり）

無効な電話番号

電話番号はE.164形式を使用する必要があります：

無効な電話番号

形式	有効？
+15125551234	はい
512-555-1234	いいえ（国コードがない、ダッシュ不可）
(512) 555-1234	いいえ（書式文字不可）

文字列長の超過

文字列長の超過

フィールド	最大長
title	255文字
description	65,000バイト
seatPostingId	250文字
sourceName	250文字

GRAPHQL_PARSE_FAILEDエラー

GRAPHQL_PARSE_FAILEDエラー

message	Syntax Error: Invalid number, expected digit but got: "a".
code	GRAPHQL_PARSE_FAILED
概要	GraphQLオペレーション文字列に構文エラーがあります。通常、このエラーはdescriptionフィールドでHTMLタグをエスケープしない場合に発生します。

GRAPHQL_PARSE_FAILEDエラーは、クエリまたはミューテーションの構文エラーを示します：

{
  "errors": [{
    "message": "Syntax Error: Invalid number, expected digit but got: \"a\".",
    "locations": [{
      "line": 7,
      "column": 33
    }],
    "extensions": {
      "code": "GRAPHQL_PARSE_FAILED"
    }
  }]
}

一般的な原因：

• 文字列値内のエスケープされていない特殊文字（引用符、バックスラッシュ）
• 不正なGraphQL構文
• 変数内の無効なJSON

注記

descriptionフィールドはdescriptionFormatting: RICH_FORMATTINGを使用する場合、生のHTMLをサポートします。HTMLタグはエスケープ不要です。

HTTP 429 Too Many Requests

レート制限を超過しました。これは、APIがHTTP 200以外のHTTPステータスコードを返す数少ないケースの1つです。

解決方法：

• Retry-Afterレスポンスヘッダーで再試行前に待機する秒数を確認。
• 大量のバッチを送信するのではなく、リクエストを時間的に分散。
• 1リクエストあたり1件の求人を送信し、時間単位のバッチではなくリアルタイムでAPIを呼び出す。

詳細については、レート制限を参照してください。

フィードタイプエラー

"All jobs on this feed must have seats"

マルチシートフィードを使用していますが、シートが含まれていません。

少なくとも1つのシートを含むseats配列を追加してください：

body: {
  title: "Software Engineer"
  location: {
    country: "US"
  }
  seats: [{
    seatPostingId: "SEAT-001"
    seatLocation: {
      country: "US"
      cityRegionPostal: "Dallas, TX 75201"
    }
  }]
}

"No jobs on this feed may have seats"

標準フィードを使用していますが、seatsが含まれています。

seats配列を削除し、求人レベルで場所を指定してください：

body: {
  title: "Software Engineer"
  location: {
    country: "US"
    cityRegionPostal: "Austin, TX 78701"
    streetAddress: "100 Congress Ave"
  }
}

ヒント

どのフィードタイプを使用しているか不明な場合は、まずseatsなしで求人を送信してみてください。

連絡先検証エラー

"No contacts found with type 'contact'"

リクエストにcontactTypeに"contact"を含む連絡先がありません。

正確に1つの連絡先がcontactType配列に"contact"を持っていることを確認してください：

contacts: [{
  contactType: ["contact", "hiring manager"]
  contactInfo: {
    email: "hr@example.com"
  }
}]

"Multiple contacts with type 'contact' found"

複数の連絡先がcontactType配列に"contact"を持っています。"contact"タイプを持つ連絡先は1つだけです。他の連絡先には"recruiter"や"hiring manager"などのタイプを使用してください。

給与検証エラー

"Maximum amount cannot be less than minimum amount"

maximumMinor値がminimumMinorより小さくなっています。

maximumMinorがminimumMinor以上であることを確認するか、最低給与のみの場合はmaximumMinorを省略してください：

salary: {
  currency: "USD"
  minimumMinor: 5000000 # $50000
  maximumMinor: 7500000 # $75000
  period: "YEAR"
}

注記

給与値は最小通貨単位（USDの場合はセント）です。$50,000 = 5000000であり、50000ではありません。

重複エントリエラー

"The request contains duplicate job entries"

各求人には一意のsourceNameとjobPostingIdのペアが必要です。同じペアがリクエスト内に複数回表示されています。

"The request contains duplicate seat entries"

各求人には一意のsourceNameとseatPostingIdのペアが必要です。同じペアがリクエスト内に複数回表示されています。

マルチシート検証エラー

"All seats must be located in the same country"

シートの場所がトップレベルの求人の場所と異なる国になっています。

すべてのシートは求人のトップレベルの場所と同じ国コードを使用する必要があります：

body: {
  location: {
    country: "US"
  }
  seats: [{
    seatPostingId: "SEAT-001"
    seatLocation: {
      country: "US"
      # トップレベルと一致する必要あり
      cityRegionPostal: "Dallas, TX 75201"
    }
  }, {
    seatPostingId: "SEAT-002"
    seatLocation: {
      country: "US"
      # トップレベルと一致する必要あり
      cityRegionPostal: "Austin, TX 78701"
    }
  }]
}

場所検証エラー

"cityRegionPostal cannot be null when remote type is not 'Fully Remote'"

リモートでない求人にはcityRegionPostalが必要です。

cityRegionPostalを指定するか、求人を完全リモートに設定してください：

# オプション1: 場所を指定
location: {
  country: "US"
  cityRegionPostal: "Austin, TX 78701"
}
# オプション2: 完全リモートに設定
location: {
  country: "US"
}
taxonomyClassification: {
  remoteType: "Fully Remote"
}

求人ライフサイクルの問題

作成した求人がIndeedに表示されない

考えられる原因：

• 求人はまだ処理中（1〜2時間待つ）。
• 求人は処理中に拒否された。
• 間違ったsourceName。

解決方法：

1. 求人が検索可能になるまで1〜2時間待つ。
2. employerJobIdを使用して求人ステータスをクエリ。
3. lifecycleStatusとisRejectedフィールドを確認。
4. sourceNameが登録済みフィードと一致することを確認。

求人が再有効化できない

求人は有効期限切れから30日以内にのみ再有効化できます。

• 30日以内の場合：元のjobPostingIdとsourceNameでcreateSourcedJobPostingsを呼び出し、datePublishedを更新

• 30日を超えた場合：新しい求人として作成（新しいsourcedPostingIdを受け取る場合があります）

求人が自動的に有効期限切れにならない

求人は自動的に有効期限切れになりません。有効期限切れにするには、明示的にexpireSourcedJobsBySourcedPostingIdを呼び出す必要があります。

リトライ戦略

Job Sync APIはアップサートパターンを使用するため、リトライは安全です。同じsourceNameとjobPostingIdで求人を送信すると、重複を作成するのではなく既存の求人を更新します。

リトライ可能なエラー

リトライ可能なエラー

エラー	リトライ可能？	戦略
HTTP 429 Too Many Requests	はい	Retry-Afterヘッダー値を待つ
ネットワークタイムアウト	はい	指数バックオフ
接続拒否	はい	指数バックオフ
FORBIDDEN（トークン期限切れ）	はい	トークンを更新してから1回リトライ
BAD_USER_INPUT	いいえ	リクエストを修正
GRAPHQL_PARSE_FAILED	いいえ	クエリ構文を修正

ベストプラクティス

• リトライにはジッター付きの指数バックオフを使用。
• 1秒の遅延から開始し、リトライごとに2倍。
• サンダリングハードを防ぐためにランダムジッター（0〜1秒）を追加。
• リトライは3〜5回に制限。

サポートを受ける

このガイドでカバーされていない問題が発生した場合：

1. GraphQLエラーのmessageとextensionsオブジェクトを確認。
2. すべての必須フィールドが存在し、正しくフォーマットされていることを確認。
3. まず最小限の入力でテストし、次にフィールドを段階的に追加。
4. フィード固有の問題についてはIndeed担当者に連絡。

参照：

• GraphQLエラーのトラブルシューティング
• OAuthエラーのトラブルシューティング
• レート制限

 

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