マイジョブ・カードAPI連携サービス
マイジョブ・カードでは、登録したジョブ・カード情報等を、民間の就職・転職サイトの登録等で利用できるAPI連携サービスを提供しています。
マイジョブ・カードAPI連携サービスとは
マイジョブ・カードAPI連携サービスとは、ジョブ・カードを活用した効果的な求職活動等の利便性の向上のため、本サイトの利用者が、登録したジョブ・カード等を活用して民間の就職・転職サイトに登録等できるよう、APIにより、民間の就職・転職サイトに対し、登録したジョブ・カード等情報の提供を行うサービスです。
詳細は、以下のガイドブックをご確認ください。
マイジョブ・カードAPI連携サービス利用ガイドブック(PDF:9.7MB)
(2022年10月26日作成版)
PDFファイルを見るためには、Adobe Readerというソフトが必要です。
Adobe Readerは無料で配布されていますので、下記のアイコンをクリックしてダウンロードしてください。
提供するAPIの⼀覧
マイジョブ・カードが提供するAPIは以下のとおりです。
No. | 機能 | 概要 |
---|---|---|
1 | トークン発行 | 認可コードからAPI の利用に必要なトークンを発行します。 |
2 | 基本情報_共通照会 | アカウント情報の一部(基本情報)をJavaScript Object Notation(以下、JSON)形式で提供します。 |
3 | キャリア・プラン情報_一般用照会 | 保有するジョブ・カード情報のうち、様式1−1(キャリア・プランシート(就業経験がある方用))の登録情報をJSON形式で提供します。 |
4 | キャリア・プラン情報_学生用 | 保有するジョブ・カード情報のうち、様式1−2(キャリア・プランシート(就業経験のない方、学卒者等用))の登録情報をJSON形式で提供します。 |
5 | 職務経歴情報_共通照会 | 保有するジョブ・カード情報のうち、様式2(職務経歴シート)の登録情報をJSON形式で提供します。 |
6 | 免許・資格情報_共通照会 | 保有するジョブ・カード情報のうち、様式3−1(職業能力証明(免許・資格)シート)の登録情報をJSON形式で提供します。 |
7 | 学習歴・訓練歴情報_共通照会 | 保有するジョブ・カード情報のうち、様式3−2(職業能力証明(学習歴・訓練歴)シート)の登録情報をJSON形式で提供します。 |
API連携サービスの利用対象
API連携サービスの対象となるAPI利用者は以下のいずれかに該当する者とします。
ただし、職業安定法または労働者派遣事業の適正な運営の確保及び派遣労働者の保護等に関する法律に基づく事業停止命令を受けている期間又は業務改善命令を受け必要な改善がなされるまでの期間は、新規に対象としません。
- 職業安定法第30条第1項に基づき有料職業紹介事業を行う事業者
- 職業安定法第33条第1項に基づき無料職業紹介事業を行う事業者
- 職業安定法第33条の3第1項に基づき無料職業紹介事業を行う特別の法人
- 労働者派遣事業の適正な運営の確保及び派遣労働者の保護等に関する法律第5条第1項に基づき労働者派遣事業を行う事業者
API連携サービスの利用手続き
利用開始までの流れは以下のとおりです。
Step1 申請書の提出
「マイジョブ・カードAPI連携サービス利用ガイドブック」記載の『3.2. 利用規約』を確認の上、「マイジョブ・カードAPI連携サービス 利用・変更・退会申請書.xlsx」の申請書に必要事項を記入してください。申請区分は、「利用」としてください。
マイジョブ・カードAPI連携サービス利用ガイドブック(PDF:9.7MB)
マイジョブ・カードAPI連携サービス 利用・変更・退会申請書(Excel:83KB)
申請書に必要事項を記入したら、以下の「メールで送付する」ボタンをクリックしてください。
メールフォームが立ち上がりますので、申請書を添付の上、メールを送付してください。
※上記のボタンから送信できない場合、myjobcard_api_reception@job-card.mhlw.go.jp宛にメールを送付してください。
厚生労働省にて審査を行い、承認が完了すると承認完了メールが送付されますので、Step2の実装の対応をしてください。
Step2 実装
「マイジョブ・カードAPI連携サービス利用ガイドブック」記載の『3.4. API仕様書』をもとに実装を行なってください。
Step3 検証環境での検証
マイジョブ・カードの検証環境と接続検証を実施してください。検証環境の利用スケジュールについては、検証開始希望日、検証を行う環境のドメイン、リダイレクトURL等を記載のうえ、メールで調整してください(その他、追加で情報提供をお願いする場合があります)。
スケジュール調整後、検証環境への接続情報(クライアントID、クライアントシークレット、マイジョブ・カード検証環境への接続情報等)を提供するので、検証する環境に設定してください。
検証完了後、検証結果をメールで報告してください。
Step4 利用開始
Step3の検証結果を確認し、問題ない場合のみ本番環境の接続情報を提供します。本番で利用する環境に設定し、利用を開始してください。
利用実績の報告
マイジョブ・カードAPI連携サービスの利用に係る実績を報告してください。
報告内容
APIによるデータ連携を行なって、貴サイトへの登録等を完了した件数。
報告頻度・期限
四半期ごとに、当該四半期の翌20日まで。
報告方法
「マイジョブ・カードAPI連携サービス利用実績報告書.xlsx」に実績を記入してください。
マイジョブ・カードAPI連携サービス利用実績報告書(Excel:28KB)
利用実績報告書に必要事項を記入したら、以下の「実績報告書を送付する」ボタンをクリックしてください。
メールフォームが立ち上がりますので、利用実績報告書を添付の上、メールを送付してください。
※ご報告にあたっては、当サイトの「プライバシーポリシー」への同意が必要です。
プライバシーポリシーに同意いただける場合は、以下『「プライバシーポリシー」に同意する』のチェックボックスにチェックを入れてください。
API連携サービスに関するお問い合わせ
民間企業向けAPIに関するお問い合わせは、メールにて受け付けています。
マイジョブ・カードの「プライバシーポリシー」ページを確認の上、メールにてお問い合わせください。
※上記のボタンから送信できない場合、myjobcard_api_reception@job-card.mhlw.go.jp宛にメールを送付してください。
注意事項
- 民間企業向けAPIに関するお問い合わせは、マイジョブ・カードの「お問い合わせ」ページからの受付を行なっておりません。
- 添付されたファイルは開封できない場合があります。メール本文にてお問い合わせいただくようお願いいたします。
- 携帯電話からメールされる方は、「@job-card.mhlw.go.jp」ドメインからの返信メールが受信できない場合があります。お持ちの携帯電話のメール受信設定をご確認ください。