Log in with Indeed

Indeed が提供する画像を使用して、Log in with Indeed ボタンを作成します。

 

法的注意

本 API および本ドキュメントを利用し、連携を構築することにより、Additional API Terms and Guidelines に同意したものとみなされます。

概要

Log in with Indeed ボタンを追加すると、ユーザーは Indeed アカウントで自社のウェブサイトにログインできます。

---

手順

1. Log in with Indeed ボタンを選ぶ

ボタンの各状態には、次の画像を使用します。ページの背景に合う列を選んでください。

Log in with Indeed ボタン

状態	明るい背景	暗い背景
デフォルト	明るい背景のデフォルトボタン	暗い背景のデフォルトボタン
ホバー	明るい背景のホバー	暗い背景のホバー
押下時	明るい背景の押下時	暗い背景の押下時
フォーカス時	明るい背景のフォーカス時	暗い背景のフォーカス時
無効	明るい背景の無効状態	暗い背景の無効状態

---

2. アプリを認可してユーザーを認証する

ユーザーがボタンをクリックしてアプリを承認すると、そのユーザーのアクセストークンを取得できます。

1. ボタンを https://secure.indeed.com/oauth/v2/authorize エンドポイントにリンクします。例:

   <a href="https://secure.indeed.com/oauth/v2/authorize?client_id=6nwwcdklwgktryjw2j5fxh5t2fyneule7zg7mvw3pf9jbx3wmewzlxkdz1jxvt7c&redirect_uri=http%3A%2F%2Fwww.acerecruitersllc.com%2Fgotcode.html&response_type=code&state=employer1234&scope=email"><img src="indeed-button.png" alt="Log in with Indeed"/></a>

2. ユーザーが Log in with Indeed をクリックすると、Indeed は OAuth 同意画面を表示します。ユーザーが Allow を選択すると、Indeed は code、iss、state パラメーターを追加して、ユーザーを redirect_uri にリダイレクトします。

3. redirect_uri へのリクエストから code の値を読み取ります。例:

   GET http://www.acerecruitersllc.com/oauth/indeed?code=rXZSMNyYQHQ&state=employer1234&iss=https%3A%2F%2Fsecure.indeed.com

4. コードをアクセストークンと交換します。

5. このアクセストークンを使用して、ユーザーに代わって Indeed API を呼び出します。

---

3. ログインしたユーザーの ID を取得する

ユーザーがアプリを承認したら、そのユーザーの Indeed アカウント ID を取得します。

1. アクセストークンを v2/api/userinfo エンドポイントに送信します。例:

   GET /v2/api/userinfo HTTP/1.1
   Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
   Host: secure.indeed.com

   レスポンスの sub には、ユーザーのアカウント ID が含まれます。アプリが email スコープをリクエストしているため、メールアドレスも含まれます。

   HTTP/1.1 200 OK
   Content-Type: application/json
   
   {
     "sub": "248289761001",
     "email": "mina.ray@myemail.world",
     "email_verified": true
   }

2. sub の値を使用して、自社のシステムでユーザーを識別します。

---

関連項目

ガイド

• 3-legged アクセストークンを取得する — 認可コードをアクセストークンと交換する方法を説明します。
• userinfo エンドポイント — ユーザーのアカウント ID とメールアドレスを取得する方法を説明します。
• 認可コードの漏えいを防ぐ — 認可コードを第三者に渡さないようにする方法を説明します。

リファレンス

• oauth/v2/authorize エンドポイント — 認可リクエストのリクエストパラメーターの一覧です。
• oauth/v2/authorize のレスポンスフィールド — Indeed が redirect_uri に追加するパラメーターの一覧です。
• v2/api/userinfo のレスポンスフィールド — このエンドポイントが返すユーザー情報フィールドの一覧です。
• 用語集 — OAuth 同意画面などの用語を定義します。

 

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