finishAppUrlパラメーター
Indeed エントリーの後にステップを追加します。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
finishAppUrlとは
#finishAppUrlは、Indeed エントリーの後にステップを追加します。求職者がそのステップを完了するまで、応募は未完了のままです。
Indeed エントリーがサポートしていない次のようなステップに使用します。
- 経歴調査などの第三者による確認。
- ビデオ面接。
- 作品サンプル。
- 適性検査。
- 複雑な質問、相互に関連する質問、またはチェックボックス形式の審査用の質問。
- 所定の形式が必要な法的書類。貴社の法務チームにご確認ください。
Indeedは、finishAppUrlに追加したパラメーターを暗号化し、追加ステップの開始時に貴社に送信します。POSTデータは後から届く場合があります。
Indeedは、次の用途でのfinishAppUrlの使用を承認していません。
| 使用できない用途 | 説明 |
|---|---|
| 重複する質問 | Indeed エントリーの質問を繰り返さないでください。 |
| アカウントの作成 | 求職者はIndeed OAuthでアカウントを作成します。 |
求人情報連携APIでこの機能を使用するには、finishApplicationUrlフィールドとapplyMethodフィールドをご覧ください。
finishAppUrlの利用条件
#広告費の要件は新規ユーザーにのみ適用されます。既存ユーザーは現在のfinishAppUrlの設定をそのまま利用できます。
-
米国、カナダ、ベルギー、スイス、ドイツ、スペイン、フランス、英国、アイルランド、オランダの場合:
- Indeedの求人数が1,000件未満: 年間300,000米ドルを超える広告費。
- Indeedの求人数が1,000件以上: 年間500,000米ドルを超える広告費。
-
その他すべての国の場合:
- Indeedの求人数が1,000件未満: 年間50,000米ドルを超える広告費。
- Indeedの求人数が1,000件以上: 年間100,000米ドルを超える広告費。
対象となるのは、検索可能な求人とスポンサー求人のみです。
追加ステップは、次の要件を満たす必要があります。
- 求職者がステップを完了するまで、応募を未完了のままにする。
- 途中で離脱した求職者を含め、Indeedからのすべての応募者を表示する。それらの応募は未完了としてマークする。
- モバイルで適切に動作する。
- Indeedの許可リストに登録されたドメインを使用する。登録されていない場合、求職者にはリダイレクト前にポップアップが表示されます。
Indeedの承認なしに使用しないでください。パラメーターの不適切な使用が判明した場合、Indeedは問題が修正されるまで貴社の連携を無効にすることがあります。採用企業のfinishAppUrlの利用を申請するには、その採用企業のIndeed担当者にお問い合わせください。
手順
#1. finishAppUrlを実装する
#次の表に従ってfinishAppUrlを設定します。その他のパラメーターについては、直接連携の採用企業向けIndeed エントリー連携ガイドまたはIndeed エントリー設定パラメーターの制限事項をご覧ください。
| パラメーター名 | 必須 | 説明 | 例 |
|---|---|---|---|
finishAppUrl | いいえ | 応募確認ページでContinueを選択した後に開くURLです。XMLではURLエンコードしてください。 | http%3A%2F%2Fwww.apply.com%2Fapply%3FindeedID%3D%7Bindeed_apply_id%7D%26email%3D%7Bemail%7D%26phone%3D%7Bphone%7D |
2. ピンバックを含める
#求職者が追加ステップを完了したら、次のURLでIndeedに通知します。
https://apply.indeed.com/indeedapply/finish_application?indeed_apply_id=<YOUR_ID>&api_token=<YOUR_TOKEN>| パラメーター | 説明 |
|---|---|
indeed_apply_id | 応募のPOSTデータに含まれるidフィールドです。 |
api_token | Indeedから発行された公開APIトークンです。 |
サポートされているfinishAppUrlのパラメーター
#これらのパラメーターは任意の順序で追加できます。各値はURL内の任意の変数に割り当てられます。
indeed_apply_id— 応募ID。name— 氏名。デフォルトで送信されるほか、data-indeed-apply-nameがfullnameの場合に送信されます。email— メールアドレス。phone— 電話番号(入力されている場合)。firstname— 名。data-indeed-apply-nameがfirstlastnameの場合にのみ送信されます。lastname— 姓。data-indeed-apply-nameがfirstlastnameの場合にのみ送信されます。
finishAppUrlの例
#data-indeed-apply-finishappurl="https://www.example.com/applyId={indeed_apply_id}&name={name}&email={email}&phone={phone}"3. 値を暗号化および復号する
#求職者がIndeed エントリーを完了すると、Indeedはパラメーターを暗号化して貴社のURLに送信します。
AES-CBCとPKCS5パディングを使用します。キーはシークレットキーの先頭16バイトです。初期化ベクトルは16バイトの00です。
値を暗号化するには、次の手順を実行します。
- 1.シークレットキーの先頭16バイトをコピーします。
- 2.値をUTF-8でエンコードします。例ではメールアドレスを使用しています。
- 3.AES-CBCとPKCS5パディングで暗号化します。
- 4.結果を16進文字列として書き出します。
暗号化と復号の例をご覧ください。
暗号化と復号の例
#using System.Text;using System.IO;using System;using System.Security.Cryptography;
public class IA_email_encryption_test{ public static void Main(string[] args) { string email = "john.doe@example.com"; string key = "your api secret key";
// only use first 16 bytes of the key byte[] keybytes = Encoding.UTF8.GetBytes(key); byte[] truncatedkeybytes = new byte[16]; Array.Copy(keybytes, truncatedkeybytes, 16); // initialization vector is all 0's; no additonal initilization required byte[] iv = new byte[16];
byte[] ciphertext = Encrypt(email, truncatedkeybytes, iv);
string hexciphertext = ByteArrayToHexString(ciphertext);
if ( !hexciphertext.Equals( "eaaacff9df2e4c2a63083a303d4521f0bd41e375232a2895310179bc030addfb" ) ) { Console.WriteLine("invalid encrypted value!"); } else { Console.WriteLine("hex encoded encrypted email: " + hexciphertext); // we decrypt merely as an exercise string decrypted = Decrypt(ciphertext, truncatedkeybytes, iv); Console.WriteLine("Decrypted E-mail: " + decrypted); } }
public static byte[] Encrypt(string plainText, byte[] key, byte[] iv) { var cypher = new AesManaged(); cypher.Mode = CipherMode.CBC; cypher.Padding = PaddingMode.PKCS7; cypher.KeySize = 128; cypher.BlockSize = 128; cypher.Key = key; cypher.IV = iv;
var icTransformer = cypher.CreateEncryptor(); var msTemp = new MemoryStream();
var csEncrypt = new CryptoStream(msTemp, icTransformer, CryptoStreamMode.Write); var sw = new StreamWriter(csEncrypt); sw.Write(plainText); sw.Close(); sw.Dispose();
csEncrypt.Clear(); csEncrypt.Dispose();
byte[] bResult = msTemp.ToArray();
return bResult; }
public static string Decrypt(byte[] ciphertext, byte[] key, byte[] iv) { var cypher = new AesManaged(); cypher.Mode = CipherMode.CBC; cypher.Padding = PaddingMode.PKCS7; cypher.KeySize = 128; cypher.BlockSize = 128; cypher.Key = key; cypher.IV = iv;
var icTransformer = cypher.CreateDecryptor(); var msTemp = new MemoryStream(ciphertext);
var csDecrypt = new CryptoStream(msTemp, icTransformer, CryptoStreamMode.Read); var sr = new StreamReader(csDecrypt);
string plaintext = sr.ReadToEnd();
csDecrypt.Clear(); csDecrypt.Dispose();
return plaintext; }
private static string ByteArrayToHexString(byte[] bytes) { StringBuilder sbHex = new StringBuilder(); foreach (byte b in bytes) sbHex.AppendFormat("{0:x2}", b); return sbHex.ToString(); }}import java.nio.ByteBuffer;import java.nio.charset.Charset;import java.lang.RuntimeException;import javax.crypto.Cipher;import javax.crypto.spec.*;import javax.crypto.spec.SecretKeySpec;public class Main { public static void main(String[] args) { String email = "john.doe@example.com"; String apiSecret = "your api secret key"; String encrypted_email = encrypt(email, apiSecret); String decrypted_email = decrypt(encrypted_email, apiSecret); if (encrypted_email.equals("eaaacff9df2e4c2a63083a303d4521f0bd41e375232a2895310179bc030addfb")) { System.out.println("B64 encoded encrypted email: " + encrypted_email); System.out.println("decrypted email: " + decrypted_email); } else { System.out.println("invalid encrypted value!"); } } static String encrypt(String message, String apiSecret) { try { // get api secret bytes byte[] keyBytes = apiSecret.getBytes(Charset.forName("UTF-8")); // get message bytes byte[] message_bytes = message.getBytes("UTF-8"); // note that we only use the first 16 bytes of the key SecretKeySpec key = new SecretKeySpec(keyBytes, 0, 16, "AES"); // get appropriate cipher using PKCS5 padding Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding"); IvParameterSpec ivspec = new IvParameterSpec(new byte[] { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }); cipher.init(Cipher.ENCRYPT_MODE, key, ivspec); // encrypt the message byte[] email_encrypted = cipher.doFinal(message_bytes); // this is the value that should be sent to Indeed return bytesToHexString(email_encrypted); } catch (Exception e) { System.out.println(e.getMessage()); throw new RuntimeException(e); } } static String decrypt(String message, String apiSecret) { try { // get api secret bytes byte[] keyBytes = apiSecret.getBytes(Charset.forName("UTF-8")); // get message bytes byte[] message_bytes = message.getBytes(Charset.forName("UTF-8")); // convert from b64 encoding message_bytes = decodeHex(message_bytes); // Create a SecretKeySpec using api secret // note that we only use the first 16 bytes of the key SecretKeySpec key = new SecretKeySpec(keyBytes, 0, 16, "AES"); // get appropriate cipher using PKCS5 padding Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding"); IvParameterSpec ivspec = new IvParameterSpec(new byte[] { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }); cipher.init(Cipher.DECRYPT_MODE, key, ivspec); // decrypt the message byte[] email_decrypted = cipher.doFinal(message_bytes); return new String(email_decrypted, "UTF-8"); } catch (Exception e) { System.out.println(e.getMessage()); throw new RuntimeException(e); } } static String bytesToHexString(byte[] in) { final StringBuilder builder = new StringBuilder(); for (byte b: in) { builder.append(String.format("%02x", b)); } return builder.toString(); } static byte[] decodeHex(byte[] data) throws Exception { String text = new String(data, "UTF-8"); char[] chars = text.toCharArray(); int len = chars.length; byte[] out = new byte[len >> 1]; int i = 0; for (int j = 0; j < len; ++i) { int f = toDigit(chars[j], j) << 4; ++j; f |= toDigit(chars[j], j); ++j; out[i] = (byte)(f & 255); } return out; } static int toDigit(char ch, int index) throws Exception { int digit = Character.digit(ch, 16); if (digit == -1) { throw new Exception("Illegal hexadecimal character " + ch + " at index " + index); } else { return digit; } }}use Crypt::CBC;use Encode;
# your secret keymy $secret = encode('UTF-8', 'your api secret key');# truncate key to 16 bytesmy $key = substr($secret, 0, 16);# initialization vector of zerosmy $iv = "\0"x 16;# create ciphermy $cipher = Crypt::CBC -> new(-literal_key => 1, -header => 'none', -key => $key, -keysize => 16, -iv => $iv, -cipher => "Crypt::OpenSSL::AES" );# Encrypt the UTF - 8 encoded string into a hex version of the datamy $email_encrypted = $cipher -> encrypt_hex(encode('UTF-8', 'john.doe@example.com'));
if ($email_encrypted eq 'eaaacff9df2e4c2a63083a303d4521f0bd41e375232a2895310179bc030addfb') { print "Hex value of encrypted: $email_encrypted\n"; # Decrypt the hex string to verify whether it is intact my $email_decrypted = $cipher -> decrypt_hex($email_encrypted); print "Decrypted: $email_decrypted\n";} else { print "invalid encrypted value! $email_encrypted\n";}function pkcs5_pad ($text) { $blocksize = 16; $pad = $blocksize - (strlen($text) % $blocksize); $text .= str_repeat(chr($pad), $pad); return $text;}
function pkcs5_unpad($text) { $pad = ord($text{strlen($text)-1}); if ($pad > strlen($text)) return false; if (strspn($text, chr($pad), strlen($text) - $pad) != $pad) return false; return substr($text, 0, -1 * $pad);}
function encrypt($str, $key) { $iv = str_repeat("\0", 16); $str = pkcs5_pad($str); $opts = OPENSSL_RAW_DATA; $encrypted = openssl_encrypt($str, 'AES-128-CBC', $key, $opts, $iv); return $encrypted;}
function decrypt($str, $key) { $iv = str_repeat("\0", 16); $opts = OPENSSL_RAW_DATA; $decrypted = openssl_decrypt($str, 'AES-128-CBC', $key, $opts, $iv); return pkcs5_unpad($decrypted);}
$api_secret = "your api secret key";$email_address = "john.doe@example.com";
// truncate api-secret to first 16 bytes$newkey = mb_strcut($api_secret, 0, 16, "UTF8");// encrypt$encrypted = encrypt($email_address, $newkey);// we decrypt merely as an exercise$decrypted = decrypt($encrypted, $newkey);// this is the value to send to Indeed$encryptedhex = bin2hex($encrypted);if($encryptedhex != "eaaacff9df2e4c2a63083a303d4521f0bd41e375232a2895310179bc030addfba655e21c3309d9343206ae55866764e8") print("invalid encrypted hex value!");print("Hex value of encrypted: " . $encryptedhex . "n");print("Decrypted: " . $decrypted . "n");# https://pypi.python.org/pypi/pycryptodome/3.5.1from Crypto.Cipher import AES
# https://pypi.python.org/pypi/pkcs7/0.1.2from pkcs7 import PKCS7Encoder
# your secret keysecret = "your api secret key".encode("utf-8")# truncate key to 16 byteskey_bytes = secret[0:16]# initialization vector of zerosiv = "\0" * 16# the email address to encryptmessage_plaintext = "john.doe@example.com"# pad the plaintext to 16 byte boundaryPKCS7encoder = PKCS7Encoder()message_plaintext_padded = PKCS7encoder.encode(message_plaintext)# encrypt the message bytescipher = AES.new(key_bytes, AES.MODE_CBC, iv)message_encrypted_raw = cipher.encrypt(message_plaintext_padded)# this is the value that should be sent to Indeedmessage_encrypted_hex = message_encrypted_raw.encode("hex")# we need a new instance for decrypt because the ciphers are statefuldecipher = AES.new(key_bytes, AES.MODE_CBC, iv)# we decrypt here simply as an exercisemessage_decrypted_raw = decipher.decrypt(message_encrypted_raw)# strip paddingmessage_decrypted = PKCS7encoder.decode(message_decrypted_raw)# confirm encrypted valueif ( message_encrypted_hex == "eaaacff9df2e4c2a63083a303d4521f0bd41e375232a2895310179bc030addfb"): print("Hex value of encrypted: " + message_encrypted_hex) print("Decrypted: " + message_decrypted)else: print("invalid encrypted value! " + message_encrypted_hex)# https://pypi.python.org/pypi/pycryptodome/3.5.1from Crypto.Cipher import AES
# https://pypi.python.org/pypi/pkcs7/0.1.2from pkcs7 import PKCS7Encoder
# your secret keysecret = "your api secret key".encode("utf-8")# truncate key to 16 byteskey_bytes = secret[0:16]# initialization vector of zerosiv = bytes("\0" * 16, encoding="UTF-8")# the email address to encryptmessage_plaintext = "john.doe@example.com"# pad the plaintext to 16 byte boundaryPKCS7encoder = PKCS7Encoder()message_plaintext_padded = PKCS7encoder.encode(message_plaintext)# encrypt the message bytesmessage_bytes = message_plaintext_padded.encode("UTF-8")cipher = AES.new(key_bytes, AES.MODE_CBC, iv)message_encrypted_raw = cipher.encrypt(message_bytes)# this is the value that should be sent to Indeedmessage_encrypted_hex = message_encrypted_raw.hex()# we decrypt here simply as an exercisedecipher = AES.new(key_bytes, AES.MODE_CBC, iv)message_decrypted_raw = decipher.decrypt(message_encrypted_raw).decode("UTF-8")# strip paddingmessage_decrypted = PKCS7encoder.decode(message_decrypted_raw)# confirm encrypted valueif ( message_encrypted_hex == "eaaacff9df2e4c2a63083a303d4521f0bd41e375232a2895310179bc030addfb"): print("Hex value of encrypted: " + message_encrypted_hex) print("Decrypted: " + message_decrypted)else: print("invalid encrypted value! " + message_encrypted_hex)https://www.example.com/applyId=6339da3ba0f6f723851334e86a0f7c34cf00f51078cc770b0cace3277f6b99df&name=54fbec6bd96ea2dfbfe3133e7a0af84f&email=977c096217b6636e446066c75a449644&phone=e258e70b1c0e3e7de3d7c0d8e65f290b暗号化された値と復号された値を比較します。
| パラメーター | 暗号化された値 | 復号された値 |
|---|---|---|
name | 54fbec6bd96ea2dfbfe3133e7a0af84f | Indeed Tester |
email | 977c096217b6636e446066c75a449644 | test@indeed.com |
phone | e258e70b1c0e3e7de3d7c0d8e65f290b | 1231231234 |
関連項目
#ガイド
#- Indeed エントリー — 求職者がIndeedで求人に応募できるようにします。
- 直接連携の採用企業向けIndeed エントリー連携ガイド — 直接連携の採用企業として、または採用企業の代理としてIndeed エントリーと連携します。
- 求人情報連携APIガイド — 求人の作成時に、
finishApplicationUrlを含むapplyMethodを設定する方法を説明します。
リファレンス
#- Indeed エントリー設定パラメーターの制限事項 — XMLフィードでIndeed エントリーを設定するパラメーターの制限事項です。
GraphQL API リファレンス
#SourcedJobPostingIndeedApplyInput—finishApplicationUrlを含みます。これは、求職者が応募確認ページで Continue を選択したときにアクセスするURLです。