シミュレーションGraphQL環境

連携時にコードをテストします。

 

廃止のお知らせ

Indeedは2026年6月30日にGraphQLシミュレーション環境を廃止します。この日までに、本環境からの移行をお願いします。

概要

Indeedは、Disposition Sync API、Job Sync API、Employer Data APIをテストするためのシミュレーションGraphQL環境を提供しています。各操作では、本番GraphQL APIの主要な動作（入力の検証、求人と雇用主の管理、シミュレーション環境内で送信された求人のステータス確認、求人応募のディスポジションデータの送信など）をシミュレーションします。本番のIndeedシステムで実行される非同期処理の一部は、シミュレーション環境ではほぼリアルタイムで実行されるため、本番システムにデータを送信せずに連携を迅速に進められます。

Indeedの本番APIにおける雇用主データと求人データの管理には、シミュレーションされない追加のタスクとプロセスが含まれます。たとえば、求人は品質チェックや重複投稿のチェックが行われます。これらのタスクとプロセスの多くはシミュレーション環境では現在有効化されていませんが、本環境を使用することで連携が正しく設定されていることを確認できます。

Indeedの本番GraphQL APIを呼び出す前に、シミュレーションGraphQL環境で連携を確認してください。

始める前に

IndeedのシミュレーションGraphQL APIは、本番のGraphQLエンドポイントとは別のhttps://simulated-apis.indeed.com/graphqlにエンドポイントがあります。IndeedのシミュレーションGraphQL APIを使用するには、本番GraphQL APIと同じ情報を指定し、エンドポイントのみ置き換えます。

シミュレーション環境の要件については、Indeedと連携してAPIを呼び出すをご覧ください。同じトークン、POSTメソッド、ヘッダーを使用する必要があります。すべてのレスポンスはIndeedの本番APIと同じ形式で、シミュレーションAPIの使用を示す_simulatedMessageフィールドが追加されます。

{
  "data": {
    "_simulatedMessage": "This is a simulated response"...
  },
  "errors": [...]
}

使用方法

雇用主データ

雇用主の作成と更新をシミュレーションします。雇用主を作成すると雇用主を更新するをご覧ください。https://simulated-apis.indeed.com/graphqlのシミュレーションGraphQL APIを使用する際は、各呼び出しに認証済みの2-legged OAuthアクセストークンが必要です。すべての雇用主データは、認可プロセスで使用されたClient Idのスコープになります。

Job Sync

求人の作成、更新、有効期限切れをシミュレーションします。求人投稿を作成する、求人投稿をアップサートする、求人投稿を有効期限切れにするをご覧ください。すべてのJob Syncデータは、認可プロセスで使用されたClient Idのスコープになります。シミュレーションGraphQL APIにのみ存在する追加の求人ステータス操作を使用すると、シミュレーション求人のステータスを確認できます。

求人ステータス

シミュレーション求人投稿呼び出しで生成されたsourcedPostingIdを指定して、求人のステータスをシミュレーションします。本番GraphQL APIで実施される非同期チェックの一部が、シミュレーション求人に対しても追加で実施されます。これらのチェックは、一般的なバリデーションの問題を特定し、連携プロセスを支援します。シミュレーション環境ではすべてのチェックとプロセスが実行されるわけではないため、動作は本番APIと異なる場合があります。

求人ステータス操作では、シミュレーション求人のアクティブまたは有効期限切れのステータス、表示状態、関連するタグが表示されます。タグは、シミュレーション求人ペイロードの無効な部分や不適切な部分を示します。

Disposition Sync

求人応募のディスポジションデータの送信をシミュレーションします。Disposition Sync APIをご覧ください。https://simulated-apis.indeed.com/graphqlのシミュレーションGraphQL APIを使用する際は、各API呼び出しに認証済みの2-legged OAuthアクセストークンが必要です。すべての雇用主データは、認可プロセスで使用されたClient Idのスコープになります。

リファレンス

雇用主データの例

シミュレーションGraphQL API環境で雇用主を作成するリクエストの例：

mutation CreateEmployerExample
{
  patchEmployer(input:
  {
    id:
    {
      type: "SAMPLE_TYPE"
      id: "EMPLOYER_ID_IN_ATS"
    }
    employerName: "Example employer"
    employerAttributes:
    {
      employerType: JURIDICAL_PERSON
      countrySpecificAttributes: [
      {
        country: "JP"
        websiteUrl: "https://example.com"
        phoneNumber: "+81123456789"
      }]
      localeSpecificAttributes: [
      {
        country: "JP"
        language: "ja"
        isGlobalDefault: true
        description: "Free text to describe the employer"
        headquarterAddress: "Minato-ku, Tokyo"
        leader:
        {
          name: "Leader name"
        }
      }]
    }
  })
  {
    responseCode
  }
}

シミュレーションGraphQL API環境で雇用主を更新するリクエストの例：

mutation UpdateDescription
{
  patchEmployer(input:
  {
    id:
    {
      type: "SAMPLE_TYPE"
      id: "EMPLOYER_ID_IN_ATS"
    }
    employerAttributes:
    {
      localeSpecificAttributes: [
      {
        country: "JP"
        language: "ja"
        description: "Updated employer description"
      }]
    }
  })
  {
    attributeUpdated
  }
}

求人投稿の例

次の呼び出し例は、シミュレーションGraphQL API環境で求人投稿を作成します。

mutation
{
  jobsIngest
  {
    createSourcedJobPostings(input:
    {
      jobPostings: [
      {
        body:
        {
          title: "title 1"
          description: "description 1"
          location:
          {
            country: "US"
            cityRegionPostal: "Syracuse, New York 13209"
          }
          benefits: []
        }
        metadata:
        {
          jobSource:
          {
            companyName: "Company"
            sourceName: "Source"
            sourceType: "Employer"
          }
          jobPostingId: "JobId1"
          datePublished: "2023-01-02T12:00Z"
          url: "http://example.com/careers/job1.html"
          contacts: [
          {
            contactType: ["contact", "recruiter"]
            contactInfo:
            {
              contactEmail: "songdatadrop2@gmail.com"
              contactPhone: "+10001112223"
              contactName: "SL1"
            }
          }]
        }
      }]
    })
    {
      results
      {
        jobPosting
        {
          sourcedPostingId
        }
      }
    }
  }
}

次の呼び出し例は、シミュレーションGraphQL API環境で求人投稿をアップサートします。

mutation {
  jobsIngest {
    createSourcedJobPostings(input: {
      jobPostings: [{
        body: {
          title: "title 1"
          description: "description 1"
          location: {
            country: "US"
            cityRegionPostal: "Syracuse, New York 13209"
          }
          benefits: []
        }
        metadata: {
          jobSource: {
            companyName: "Company"
            sourceName: "Source"
            sourceType: "Employer"
          }
          jobPostingId: "JobId1"
          datePublished: "2023-01-02T12:00Z"
          url: "http://example.com/careers/job1.html"
          contacts: [{
            contactType: ["contact", "recruiter"]
            contactInfo: {
              contactEmail: "songdatadrop2@gmail.com"
              contactPhone: "+10001112223"
              contactName: "SL1"
            }
          }]
        }
      }]
    }) {
      results {
        jobPosting {
          sourcedPostingId
        }
      }
    }
  }
}

次の呼び出し例は、シミュレーションGraphQL API環境で求人投稿を有効期限切れにします。

mutation {
  jobsIngest {
    expireSourcedJobsBySourcedPostingId(
      input: {
        jobs: [{ sourcedPostingId: "YOUR_SOURCED_POSTING_ID" }]
      }
    ) {
      results {
        trackingKey
      }
    }
  }
}

求人ステータスの例

次の呼び出し例は、シミュレーションGraphQL API環境でシミュレーション求人ステータスを取得します。

query CheckJobStatus {
  findSimulatedJobStatuses(input: {
    sourcedPostingIds: ["YOUR_SOURCED_POSTING_ID"]
  }) {
    results {
      isActive
      simulatedModerationMessages
      sourcedPostingId
      visibilityLevel
    }
  }
}

求人ディスポジションデータの送信例

次の呼び出し例は、シミュレーションGraphQL API環境でディスポジションデータを送信します。

mutation ExampleSimulatedDisposition {
  partnerDisposition {
    send(
      input: {
        dispositions: [
          {
            atsName: "ExampleATS"
            dispositionStatus: LIKED
            identifiedBy: { indeedApplyID: "1234567890" }
            rawDispositionDetails: "Job liked on portal"
            rawDispositionStatus: "Like job"
            statusChangeDateTime: "2025-02-25T10:00:00Z"
          }
        ]
      }
    ) {
      numberGoodDispositions
      failedDispositions {
        identifiedBy {
          indeedApplyID
          ittk
          universalApplyId
          alternateIdentifier {
            jobIdentifier {
                indeedJobKey
                employerJobId
                atsApplicationIdentifier {  
                    requisitionId
                    companyName
                    applicationId
                }
              indeedJobKey
            }
            jobSeekerIdentifier {
              indeedJobSeekerKey
              emailAddress
            }
          }
        }
        rationale
      }
    }
  }
}

関連リンク

• Job Sync APIのよくある質問
• GraphQLエラーのトラブルシューティング
• サポート

 

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