Indeedと連携してAPIを呼び出す

OAuth認証情報を取得して、初回のAPIを呼び出します。

 

法的注意

このAPIとそのドキュメントを使用して連携を構築すると、APIに関する追加の利用規約およびガイドラインに同意したことになります。

概要

Indeedパートナーになると、Indeedが連携用のアプリを作成します。Partner Consoleにログインして、アプリとOAuth認証情報（クライアントID、クライアントシークレット、および3-legged OAuthの場合は認可コード）を確認します。認証情報をアクセストークンと交換し、API呼び出しを認証します。

Indeedパートナーになる

まだパートナーでない場合は、Indeedパートナーにご登録ください。

OAuth認証情報を取得する

1. IndeedユーザーアカウントでPartner Consoleにログインします（Partner Console）。

2. ダッシュボードのAppsリストでアプリを選択します。

   アプリの詳細ページのCredentialsタブに、OAuth認証情報（クライアントIDとクライアントシークレット）が表示されます。

アクセストークンを取得する

アクセストークンを取得するには、curlなどのコマンドラインツールやInsomniaなどのUIツールを使用して、次のヘッダーとボディパラメーターでhttps://apis.indeed.com/oauth/v2/tokensにPOSTリクエストを送信します。

クライアントシークレットはエンドユーザーに公開しないでください。Indeedでは、トークンをバックエンドで生成することを推奨しています。

curl -L 'https://apis.indeed.com/oauth/v2/tokens' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'client_id=<client_id>' \
  -d 'client_secret=<client_secret>' \
  -d 'grant_type=client_credentials' \
  -d 'scope=employer_access'

リクエストヘッダーは次のとおりです。

アクセストークン取得のリクエストヘッダー

ヘッダー	値
Accept	application/json
Content-Type	application/x-www-form-urlencoded

リクエストボディのパラメーターは次のとおりです。

アクセストークン取得のリクエストボディのパラメーター

リクエストボディのパラメーター	値	説明
client_id	<client_id>	自身のクライアントIDに置き換えます。
client_secret	<client_secret>	自身のクライアントシークレットに置き換えます。
grant_type	client_credentials	クライアントクレデンシャルグラント（2-legged OAuth）をリクエストします。
scope	employer_access	アプリを登録したユーザーに関連付けられている雇用主アカウントを一覧表示するか、関連付けられている雇用主アカウントのアクセストークンを取得します。

{
  "access_token": "<access_token>",
  "scope": "employer_access",
  "token_type": "Bearer",
  "expires_in": 3600
}

トークンの有効期間は1時間（3600秒）です。トークンは1時間ごとに更新してください。

Indeed APIを呼び出す

Indeed GraphQL APIを呼び出すには、以下のヘッダーとGraphQLクエリまたはミューテーションを指定してhttps://apis.indeed.com/graphqlにPOSTリクエストを送信します。

curl -L 'https://apis.indeed.com/graphql' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{"query":"query {\n  jobSearch(\n    location: { radius: 5, radiusUnit: MILES, where: \"Austin\" }\n    what: \"Nurse\"\n    limit: 5\n  ) {\n    results {\n      job {\n        title\n        sourceEmployerName\n      }\n    }\n  }\n}","variables":{}}'

リクエストヘッダー：

Basic認証スキームもご覧ください。

HTTPリクエストヘッダー

ヘッダー	値	説明
Authorization	Bearer <token>	サーバーで認証して、保護されたリソースにアクセスします。 このヘッダーでBearer認証スキームを使用してアクセストークンを渡します。 注記 oauth/v2/tokensエンドポイントでは、リクエストボディでclient_idとclient_secretを渡す代わりに、Basic認証スキームを使用できます。 アクセストークンを取得するおよびAuthorizationヘッダーをご覧ください。
Content-Type	application/json	リソースのメディアタイプ。 Content-Typeヘッダーをご覧ください。

-dパラメーターでGraphQLクエリを指定します。

query {
  jobSearch(location: {
      radius: 5,
      radiusUnit: MILES,
      where: "Austin"
    }
    what: "Nurse"
    limit: 5) {
    results {
      job {
        title
        sourceEmployerName
      }
    }
  }
}

{
  "errors": [{
    "message": "The client does not have access to the 'job-retrieval-service' service.",
    "extensions": {
      "code": "INTERNAL_SERVER_ERROR"
    }
  }],
  "data": null
}

関連項目

• oauth/v2/tokensエンドポイント
• HTTPリクエストヘッダー
• サンプル雇用主を作成する
• サンプル求人を作成する
• OAuth 2.0 Client for Java/Kotlin
• GraphQL APIリファレンス
• GraphQLエラーのトラブルシューティング
• OAuthエラーのトラブルシューティング

 

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