マイジョブ・カード
API連携サービス
利⽤ガイドブック
1.0版
2022年10⽉

改訂履歴

改訂年⽉⽇
2022/10/26

改訂箇所
-改訂内容
初版

2目次

1. はじめに1.1. マイジョブ・カードAPI連携サービスとは
1.2. 本書の目的
1.3. 本書の表記
1.4. 別紙一覧
2. サービスの概要
2.1. 提供するAPIの一覧
2.2. APIの利用イメージ
2.3. 利用対象
2.4. アカウント情報データについて
2.5. ジョブ・カード情報データについて
2.6. ジョブ・カード等情報の文字コード
2.7. 利用上の注意
3. サービスの利用方法
3.1. 利用開始までのフロー
3.2. 利用規約
3.3. 申請書（記載方法）
3.4. API仕様書
4. 利用実績の報告
5. 各種手続方法
6. よくあるご質問

3

１．はじめに

1.1.

マイジョブ・カードAPI連携サービスとはマイジョブ・カードAPI連携サービスとは、ジョブ・カードを活⽤した効果的な求職活動等の利便性の向上のため、本サイトの利⽤者が、登録したジョブ・カード等を活⽤して⺠間の就職・転職サイトに登録等できるよう、APIにより、⺠間の就職・転職サイトに対し、登録したジョブ・カード等情報の提供を⾏うサービスです。

1.2.

本書の⽬的

本書は、⺠間の就職・転職サイト等がマイジョブ・カードAPI連携サービスを利⽤するにあたっての申請⽅法や、アカウント情報データ・ジョブ・カード様式情報データを取得するためのApplication
Program Interface(以下、API)の仕様について 記載しています。

1.3.

本書の表記

本書では以下の表記を使⽤しています。

記号・マーク
「 」

1.4.

意味
項⽬名や画⾯名を表しています。
例）「ログイン」ページ、「登録する」

注意

必ず読んでもらいたい情報や注意事項を記載しています。

Point！

知っておくと便利なことを補⾜、紹介しています。

別紙⼀覧• マイジョブ・カードAPI連携サービス 利⽤・変更・退会申請書.xlsx• マイジョブ・カードAPI連携サービス 利⽤実績報告書.xlsx

4２．サービスの概要2.1.

提供するAPIの⼀覧

No.

機能概要

1

トークン発⾏

認可コードからAPI の利⽤に必要なトークンを発⾏します。

2

基本情報_共通照会

アカウント情報の⼀部（基本情報）をJavaScript Object
Notation（以下、JSON）形式で提供します。

3

キャリア・プラン情報_⼀般⽤照会

保有するジョブ・カード情報のうち、様式１−１（キャリア・プランシート（就業経験がある⽅⽤））の登録情報をJSON形式で提供します。

4

キャリア・プラン情報_学⽣⽤照会

保有するジョブ・カード情報のうち、様式１−２（キャリア・プランシート（就業経験のない⽅、学卒者等⽤））の登録情報をJSON形式で提供します。

5

職務経歴情報_共通照会

保有するジョブ・カード情報のうち、様式２（職務経歴シート）の登録情報をJSON形式で提供します。

6

免許・資格情報_共通照会

保有するジョブ・カード情報のうち、様式３−１（職業能⼒証明（免許・資格）シート）の登録情報をJSON形式で提供します。

7

学習歴・訓練歴情報_共通照会

保有するジョブ・カード情報のうち、様式３−２（職業能⼒証明（学習歴・訓練歴）シート）の登録情報をJSON形式で提供します。

5

２．サービスの概要

2.2.

API利⽤のイメージ
利⽤者が作成したプログラム等

マイジョブ・カード
接続元認証情報（※1）

認証認可画⾯の呼び出し

認証認可画⾯⺠間サイト利⽤者が認証実施
認可コード

トークン登録の呼び出し

認可コード

トークン発⾏
トークン
・リフレッシュトークン

トークン登録の呼び出し（※2）

リフレッシュ
トークン
トークン発⾏

トークン
・リフレッシュトークン【凡例】
・・・機能・・・リクエストの流れ・・・引数・・・レスポンス

・・・レスポンスの流れ※1 接続元認証情報は、利⽤申請の承認後提供される情報です。
※2 トークンを更新する場合、実施するものです。
6

２．サービスの概要

利⽤者が作成したプログラム等

基本情報_共通照会の呼び出し

マイジョブ・カードトークン
基本情報_共通照会

JSON

キャリア・プラン情報_⼀般⽤照会の呼び出し

トークン
キャリア・プラン情報_⼀般⽤照会

JSON
キャリア・プラン情報_学⽣⽤照会の呼び出し

トークン
キャリア・プラン情報_学⽣⽤照会

JSON
職務経歴情報_共通照会の呼び出し

トークン
職務経歴情報_共通照会

JSON
免許・資格情報_共通照会の呼び出し

トークン
免許・資格情報_共通照会

JSON
【凡例】
・・・機能・・・リクエストの流れ

・・・引数
・・・レスポンス・・・レスポンスの流れ

7

２．サービスの概要
利⽤者が作成したプログラム等

学習歴・訓練歴情報_共通照会の呼び出し

マイジョブ・カード

トークン
学習歴・訓練歴情報_共通照会

JSON

【凡例】
・・・機能・・・リクエストの流れ

・・・引数
・・・レスポンス・・・レスポンスの流れ

8

２．サービスの概要

2.3.

利⽤対象

API連携サービスの対象となるAPI利⽤者は以下のいずれかに該当する者とします。
ただし、職業安定法または労働者派遣事業の適正な運営の確保及び派遣労働者の保護等に関する法律に基づく事業停⽌命令を受けている期間⼜は業務改善命令を受け必要な改善がなされるまでの期間は、新規に対象としません。
（１） 職業安定法第３０条第１項に基づき有料職業紹介事業を⾏う事業者（２） 職業安定法第３３条第１項に基づき無料職業紹介事業を⾏う事業者（３） 職業安定法第３３条の３第１項に基づき無料職業紹介事業を⾏う特別の法⼈（４） 労働者派遣事業の適正な運営の確保及び派遣労働者の保護等に関する法律第５条第１項に基づき労働者派遣事業を⾏う事業者

2.4.

アカウント情報データについてアカウント情報データは、マイジョブ・カードに登録しているアカウント情報をJSON形式で提供します。
API仕様書： 基本情報_共通照会

2.5.

ジョブ・カード情報データについて

ジョブ・カード情報データは以下の種類で様式ごとに分割してJSON形式で提供しています。
（1）様式１−１ キャリア・プランシート（就業経験がある⽅⽤）
API仕様書： キャリア・プラン情報_⼀般⽤照会（2）様式１−２ キャリア・プランシート（就業経験のない⽅・⾼卒者等⽤）
API仕様書： キャリア・プラン情報_学⽣⽤照会（3）様式２ 職務経歴シート
API仕様書： 職務経歴情報_共通照会（4）様式３−１ 職業能⼒証明（免許・資格）シート
API仕様書： 免許・資格情報_共通照会（5）様式３−２ 職業能⼒証明（学習歴・訓練歴）シート
API仕様書： 学習歴・訓練歴情報_共通照会

9２．サービスの概要

2.6.

ジョブ・カード等情報の⽂字コード取得できるJSON形式のデータの⽂字コードは、「UTF-8」です。また、改⾏コードは、「LF」です。

2.7.

利⽤上の注意利⽤制限についてマイジョブ・カードでは時間ごとのAPIアクセス数の上限を設けており、5分あたり30000リクエストを超えた場合に、⼀定時間アクセスを拒否します。

メンテナンスの通知⽅法
マイジョブ・カードは定期的なメンテナンスは実施していません。メンテナンスを実施する場合は、マイジョブ・カードの「お知らせ」ページ（https://job-card.mhlw.go.jp/new-info）にて通知しますのでご確認ください。

メンテナンス実地中の動作についてマイジョブ・カードがメンテナンス実施中の場合は、HTTP ステータスコード 503 を返却します。

10３．サービスの利⽤⽅法

3.1.

利⽤開始までのフロー利⽤開始までの流れは以下の通りです。

①申請書の提出②実装③検証環境での検証④利⽤開始①申請書の提出
利⽤規約を確認の上、別紙「マイジョブ・カードAPI連携サービス 利⽤・変更・退会申請書.xlsx」に、申請区分を「利⽤」とし必要事項を⼊⼒して、以下のメールアドレスまで送付してください。
myjobcard_api_reception@job-card.mhlw.go.jp
厚⽣労働省にて審査を⾏い、承認が完了すると承認完了メールが送付されますので、②実装の対応をしてください。

②実装
3.4. API仕様書をもとに実装を⾏なってください。

実装等各種⼿続きにて、困ったことがある場合は、「よくあるご質問」を参照してください。

11３．サービスの利⽤⽅法③検証環境での検証
マイジョブ・カードの検証環境と接続検証を実施してください。検証環境の利⽤スケジュールについては、検証開始希望⽇、検証を⾏う環境のドメイン、リダイレクトURL等を記載のうえ、メールで調整
してください（その他、追加で情報提供をお願いする場合があります）。
スケジュール調整後、検証環境への接続情報（クライアントID、クライアントシークレット、マイジョブ・カード検証環境への接続情報等）を提供するので、検証する環境に設定してください。
検証完了後、検証結果をメールで報告してください。

④利⽤開始③の検証結果を確認し、問題ない場合のみ本番環境の接続情報を提供します。本番で利⽤する環境に設定し、利⽤を開始してください。

「③検証環境での検証」は、利⽤者のローカル環境や本番環境との疎通はできません。必ず検証環境を⽤意してください。
12

３．サービスの利⽤⽅法

3.2.

利⽤規約

13

３．サービスの利⽤⽅法

14

３．サービスの利⽤⽅法

15

３．サービスの利⽤⽅法

16

３．サービスの利⽤⽅法

17

３．サービスの利⽤⽅法

18

３．サービスの利⽤⽅法

19

３．サービスの利⽤⽅法

3.3.

申請書の記載⽅法
該当する申請区分にチェックを⼊れてください。
申請区分いついては、
５．各種⼿続⽅法を□ 退会 〕ご参照ください。

マイジョブ・カードAPI連携サービス 利⽤・変更・退会申請書
厚⽣労働省 御中
申請区分 〔 ☑ 利⽤
申請⽇□ 変更
令和4年10⽉26⽇〔〕

マイジョブ・カードAPI連携サービスについて、利⽤規約及びマイジョブ・カードAPI連携サービス利⽤ガイドブックに同意のうえ、下記のとおり申請します。

③ いずれも許可を受けている場合は、連携を希望するサ
イトの⽬的に近いほうに☑し） てください。

１. 申請内容欄（フリガナ） マイキャリアカブシキガイシャ（〒①法⼈・団体の名称

―8055

②所在地
マイキャリア株式会社③事業者の区分☑

東京都千代⽥区⼤⼿町1－2－2

職業紹介事業者□

労働者派遣事業者④許可・届出受理番号 01-ユ-000001

平成10年10⽉26⽇⑥有効期限年⽉⽇⑤許可年⽉⽇⑦連携希望のマイキャリア・オンライン
就職・転職サイト名称

⑨利⽤⽬的

100

令和6年10⽉26⽇⑧サイトURL⑧ ⑦のURLを記載
してください。

'112!344555&,-.(/00/&.*,

サイトへの登録、ジョブ・カード内容を踏まえた⾼度なマッチング ⑩利⽤開始／変更／退の実装を⾏う⽬的
会希望年⽉⽇

令和5年4⽉1⽇

連絡担当者（フリガナ） スズキ ハナコ（〒⑪⽒名100―8055）

⑫常駐場所
鈴⽊ 花⼦

東京都千代⽥区⼤⼿町1－2－2⑬組織・役職 キャリア事業本部・課⻑代理

⑮電話番号

03

⑩ 利⽤申請の場合は利⽤開始年⽉⽇、変更申請の場合は変更⽇、退会申請の場合は、退会希望年⽉⽇を記載してください。

―5253⑭メールアドレス―

1111⑯FAX番号!"#"$%&'()($*+,-.(/00/&.*,
―

⑰備考欄

―

⑨ API連携をどのように利⽤する予定か（サイトへの登録、ジョブ・カード内容を踏まえた⾼度なマッチング等）記⼊してください。
書ききれない場合は、別紙を添付して頂いても結構です。

2. 申請者確認欄

上記内容について確認します。

申請者⽒名

︓

原則として、①の代表者（押印不要）を記載してください。

（厚⽣労働省記載欄）

審査結果連絡欄□ 申請を承認します。

□

申請を承認しません。

20

３．サービスの利⽤⽅法

3.4.

API仕様書No1

トークン発⾏＜リクエスト情報（HTTPメソッド）＞
POST＜リクエスト情報（URLリクエストパス）＞/api/oauth/token＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞＜レスポンス情報（異常系）＞

21

３．サービスの利⽤⽅法＜エラーコード＞

22

３．サービスの利⽤⽅法
No2

基本情報_共通照会＜リクエスト情報（HTTPメソッド）＞
GET＜リクエスト情報（URLリクエストパス）＞/api/user＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞

23

３．サービスの利⽤⽅法＜レスポンス情報（異常系）＞＜エラーコード＞

24

３．サービスの利⽤⽅法No3

キャリア・プラン情報_⼀般⽤照会＜リクエスト情報（HTTPメソッド）＞
GET＜リクエスト情報（URLリクエストパス）＞/api/style1_1＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞＜レスポンス情報（異常系）＞＜エラーコード＞

25

３．サービスの利⽤⽅法
No4

キャリア・プラン情報_学⽣⽤照会＜リクエスト情報（HTTPメソッド）＞
GET＜リクエスト情報（URLリクエストパス）＞/api/style1_2＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞

26

３．サービスの利⽤⽅法

27

３．サービスの利⽤⽅法

28

３．サービスの利⽤⽅法

29

３．サービスの利⽤⽅法

30

３．サービスの利⽤⽅法

31

３．サービスの利⽤⽅法

32

３．サービスの利⽤⽅法＜レスポンス情報（異常系）＞＜エラーコード＞

33

３．サービスの利⽤⽅法
No5

職務経歴情報_共通照会＜リクエスト情報（HTTPメソッド）＞
GET＜リクエスト情報（URLリクエストパス）＞/api/style2＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞

34

３．サービスの利⽤⽅法

35

３．サービスの利⽤⽅法

36

３．サービスの利⽤⽅法

37

３．サービスの利⽤⽅法

38

３．サービスの利⽤⽅法

39

３．サービスの利⽤⽅法

40

３．サービスの利⽤⽅法

41

３．サービスの利⽤⽅法

42

３．サービスの利⽤⽅法

43

３．サービスの利⽤⽅法

44

３．サービスの利⽤⽅法

45

３．サービスの利⽤⽅法

46

３．サービスの利⽤⽅法＜レスポンス情報（異常系）＞＜エラーコード＞

47

３．サービスの利⽤⽅法
No6

免許・資格情報_共通照会＜リクエスト情報（HTTPメソッド）＞
GET＜リクエスト情報（URLリクエストパス）＞/api/style3_1＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞48

３．サービスの利⽤⽅法

49

３．サービスの利⽤⽅法

50

３．サービスの利⽤⽅法

51

３．サービスの利⽤⽅法

52

３．サービスの利⽤⽅法

53

３．サービスの利⽤⽅法

54

３．サービスの利⽤⽅法

55

３．サービスの利⽤⽅法＜レスポンス情報（異常系）＞＜エラーコード＞

56

３．サービスの利⽤⽅法
No7

学習歴・訓練歴情報_共通照会＜リクエスト情報（HTTPメソッド）＞
GET＜リクエスト情報（URLリクエストパス）＞/api/style3_2＜リクエスト情報（HTTPリクエストヘッダ）＞＜リクエスト情報（クエリパラメータ）＞なし＜レスポンス情報（正常系）＞

57

３．サービスの利⽤⽅法

58

３．サービスの利⽤⽅法

59

３．サービスの利⽤⽅法

60

３．サービスの利⽤⽅法＜レスポンス情報（異常系）＞＜エラーコード＞

61

４．利⽤実績の報告（１）報告内容
APIによるデータ連携を⾏なって、貴サイトへの登録等を完了した件数。
（２）報告頻度・期限
四半期ごとに、当該四半期の翌２０⽇まで。
（３）報告⽅法
別紙の報告様式（Excel）に⼊⼒のうえ、以下のメールアドレス宛に添付して提出ください。

myjobcard_api_reception@job-card.mhlw.go.jp（４）記載例

マイジョブ・カードAPI連携サービス 利⽤実績報告書
API連携サービスを利⽤しているサイト名称をご記⼊ください。

連携サイト名称

マイキャリア・オンライン

報告対象期間

令和

5

年

第2四半期

報告対象の年度・四半期をご記⼊ください。

APIによるデータ連携を⾏なって登録等を完了した件数
7

⽉

46件

8

⽉

57件

9

⽉

72件

175件

期間合計

報告対象の四半期の⽉及びその⽉に、APIによるデータ連携を⾏なって、貴サイトへの登録等を完了した件数ご記⼊ください。

５．各種⼿続⽅法

申請書の提出先メールアドレス
myjobcard_api_reception@job-card.mhlw.go.jp
申請区分

利⽤

申請の契機

申請期限

申請⽅法

API連携サービスの利⽤を希望する場合―※申請から利⽤開始までの期間は、申請者の開発期間、連携テストの状況による。

「マイジョブ・カードAPI連携サービス
利⽤・変更・退会申請書」を、提出先メールアドレス宛にメールで提出

職業紹介事業⼜は労働者派遣事業の許可を更新した場合許可の有効期限まで「マイジョブ・カードAPI連携サービス
利⽤・変更・退会申請書」を、提出先メールアドレス宛にメールで提出

変更
上記以外の申請書記載内容に変更がある場合変更が⽣じたら直ちに

API連携サービスの退会を希望する場合

退会希望⽇の１か⽉以上前まで「マイジョブ・カードAPI連携サービス
利⽤・変更・退会申請書」を、提出先メールアドレス宛にメールで提出

退会
職業紹介事業⼜は労働者派遣事業の許可を廃⽌した場合廃⽌⽇まで※可能な限り早く63

６．よくあるご質問

申請書はどこから取得できますか
マイジョブ・カードの「API連携サービス」ページより取得してください。

認証リクエスト時の認証認可画⾯はデバイスによりURLが変わりますか
マイジョブ・カードはレスポンシブデザインで構成されているため、パソコン、スマートフォン等に関わらずURLは同⼀です。

接続元IPアドレスは固定である必要がありますか固定である必要はありません。

厚⽣労働省編職業分類の選択値の⼀覧はありますか
ハローワークインターネットサービスの職業分類に関するご案内からダウンロードできます（マイジョブ・カードでは令和４年改正の厚⽣労働省編職業分類を使⽤しています）。

ハローワークインターネットサービス
りますか

免許・資格コードの選択値の⼀覧はあハローワークインターネットサービスの免許・資格コード⼀覧（⼤分類）から参照することができます。

その他API連携サービスに関するお問い合わせ
⺠間企業向けAPIに関するお問い合わせはメールにて受け付けています。マイジョブ・カードの「プライバシーポリシー」ページを確認の上、以下のメールアドレスまでお問い合わせください。
myjobcard_api_reception@job-card.mhlw.go.jp【注意事項】
・⺠間企業向けAPIに関するお問い合わせは、マイジョブ・カードの「お問い合わせ」ページからの受付を⾏なっておりません。
・添付されたファイルは開封できない場合があります。メール本⽂にてお問い合わせいただくようお願いいたします。
・携帯電話からメールされる⽅は、「@job-card.mhlw.go.jp」ドメインからの返信メールが受信できない場合があります。お持ちの携帯電話のメール受信設定をご確認ください。
64