ジョブカンのAPIは、製品ごとに公開のされ方が違います。仕様書が誰でも読める形で公開されているのは経費精算とワークフローのAPI(β版)で、勤怠管理は連携先サービスを通じた申込制の連携が中心です。この記事では、経費精算/ワークフローAPIのトークン発行からcurlでの疎通確認、Pythonで申請書の一覧を全件取得する実装、1時間5000回という上限への対処までをコード付きで示し、勤怠管理のデータを給与計算や自社システムへ渡すときの申込手順と連携方式A・Bの違いを整理します。仕様は2026年11月21日時点の公式ドキュメントの記載にもとづきます。
まとめ:ジョブカンのAPIは製品ごとに公開範囲と認証方式が違う
経費精算とワークフローのデータを自社システムから読み書きしたいなら、公開仕様書のあるジョブカン経費精算/ワークフローAPI(β版)をそのまま使えます。認証は管理画面で発行するAPIトークンを Authorization: Token ... ヘッダに載せる方式で、GETは1回100件まで、続きはレスポンスの next にURLが入ります。上限は1トークンあたり1時間5000回です。
勤怠管理のデータは事情が違います。確認できる範囲では勤怠管理単体のAPI仕様書は一般公開されておらず、マネーフォワード クラウド給与のような連携先サービスから、事前の申込を経てつなぐ形が基本です。無料プランではAPI連携を使えません。自社開発のシステムへ勤怠データを渡したい場合は、ジョブカンへの申込と提供範囲の確認から始めます。
β版のAPIは仕様が変わる前提で組みます。夜間の一括取り込みのように失敗しても翌日に再実行できる処理には向きますが、決済や給与確定のように止まると業務が止まる処理の唯一の経路にはしません。
ジョブカンで使えるAPIの範囲:経費精算・ワークフローAPIと勤怠連携の違い
ジョブカンは勤怠管理・ワークフロー・経費精算・労務HR・給与計算などを別製品として提供しています。APIの入口も製品単位で分かれており、「ジョブカンのAPI」と言っても、どの製品のデータを扱うかで手順がまったく違います。
| 製品 | 仕様書の公開 | 認証 | 利用の入口 |
|---|---|---|---|
| 経費精算・ワークフロー | 公開(β版) | APIトークン | 管理画面で発行 |
| 勤怠管理(連携A) | 一般公開なし | 勤怠会社ID | 事前の申込が必要 |
| 勤怠管理(連携B) | 一般公開なし | 接続文字列 | 旧APIを利用 |
経費精算/ワークフローAPIで扱えるのは、ユーザー・グループ・役職・プロジェクト・取引先(会社)・汎用マスタの登録と更新、申請書の一覧と詳細の取得、確定済みで未出力の仕訳の取得と出力済みへの更新、添付ファイルのダウンロード、交通系ICカード履歴の登録です。申請書は取得のみで、APIから申請を新しく起こすことはできません。人事システムを正としてユーザーと組織を流し込み、承認の済んだ仕訳を会計システムへ取り出す、という2方向の連携がこのAPIの主な使い道になります。
APIでつなぐかCSVの受け渡しで済ませるかの判断はAPI連携とは?仕組みとデータ連携・CSV連携・Webhookとの違いで整理しています。ワークフロー製品そのものの選び方はワークフローシステムとは?パッケージ・クラウド・オンプレミスの違いと基幹連携・自社開発の判断基準を参照してください。
経費精算・ワークフローAPIを試す:トークン発行とcurlでの疎通確認の手順
最初にAPIトークンを管理画面で発行します。公式ドキュメントの記載では、トークンは管理画面から取得し、リクエストごとに Authorization ヘッダへ「Token」の後ろに半角スペースを1つ置いて付けます。ベースURLは https://ssl.wf.jobcan.jp/wf_api/ です。トークンを取得したら、疎通確認用の /test/ を呼びます。
export JOBCAN_WF_TOKEN="管理画面で発行したAPIトークン"
# 疎通確認(トークンが正しければ200が返る)
curl -s -w "\nHTTP %{http_code}\n" \
-H "Authorization: Token ${JOBCAN_WF_TOKEN}" \
"https://ssl.wf.jobcan.jp/wf_api/test/"
# ユーザー一覧(v3)
curl -s \
-H "Authorization: Token ${JOBCAN_WF_TOKEN}" \
"https://ssl.wf.jobcan.jp/wf_api/v3/users/"
リソースによってv1・v2・v3の版が併存しています。ユーザーはv1からv3まで、申請書の一覧はv1とv2があり、新しく組むなら各リソースの新しい版を選んでください。登録(POST)と更新(PUT)では Content-Type: application/json を付け、本文にJSONを送ります。
エラーはHTTPステータスに加えて、本文の code に6桁の番号が入ります。たとえば申請書詳細で対象が無いと404と 400004、パラメータが不正なら400と 400003、JSONの形が誤っていれば400と 400100、サーバー側の想定外の失敗は500と 500000 です。ログにはステータスだけでなくこの番号も残すと、問い合わせのときに話が早くなります。
トークンは管理者権限に相当する鍵です。リポジトリやスクリプトに直書きせず、環境変数やクラウドのシークレット管理に置き、担当者の異動時に再発行する運用を決めておきます。
Pythonで申請書一覧を全件取得する:100件ページングとレート制限の扱い
一覧系のGETは1回で最大100件を返し、続きがあればレスポンスの next に次ページのURLが入ります。最後のページでは next が null です。申請書一覧v2は申請ID・状態・申請書の様式ID・申請日時や完了日時の範囲で絞り込めるので、日次の取り込みなら「前回の取り込み以降に完了した申請」だけを取ります。日時は yyyy/mm/dd hh:mm:ss か yyyy/mm/dd の形式で渡します。
import os
import time
import requests
BASE = "https://ssl.wf.jobcan.jp/wf_api"
HEADERS = {"Authorization": f"Token {os.environ['JOBCAN_WF_TOKEN']}"}
def fetch_all(url, params=None):
"""nextをたどって一覧を全件取得する(1ページ最大100件)"""
results = []
while url:
res = requests.get(url, headers=HEADERS, params=params, timeout=30)
if res.status_code == 429 or res.status_code >= 500:
# 上限超過やサーバー側の失敗は待ってから再試行する
time.sleep(60)
continue
res.raise_for_status()
body = res.json()
results.extend(body.get("results", []))
url = body.get("next")
params = None # nextのURLに条件が含まれるため2ページ目以降は付けない
time.sleep(0.8) # 1時間5000回(平均0.72秒に1回)を超えない間隔
return results
requests_done = fetch_all(
f"{BASE}/v2/requests/",
params={"status": "completed", "completed_after": "2026/11/20 00:00:00"},
)
print(len(requests_done))
上限は1アクセストークンあたり1時間5000回で、超えるとエラーになります。5000回は平均すると0.72秒に1回なので、上のコードで設定したリクエスト間隔は0.8秒です。申請書の詳細(/v1/requests/{request_id}/)を1件ずつ取りにいく処理は、一覧の件数がそのまま回数になるため、月末に数千件が完了する会社では一晩の取り込みで上限に届きます。詳細が必要な項目を絞るか、取り込みを日次に分けて回数を均してください。超過時に返るステータスはドキュメントに明記されていないため、上のコードは429と5xxをまとめて待機の対象にしています。実際に返る値は検証環境で確かめてから本番の分岐を固めてください。
レスポンスの日時表記は統一されていません。申請日時は 2021-03-08T13:42:23+09:00 のようなISO 8601形式で、仕訳日や利用日は 2022/06/01 のようなスラッシュ区切りです。取り込み側で項目ごとに変換処理を分けておかないと、会計システムへの書き込みで日付の解釈がずれます。
仕訳の連携には専用のエンドポイントが用意されています。GET /v1/fix_journals/unprinted/ は確定済みで未出力の仕訳を1ページ1000件で返し、journal_type に book(計上仕訳)か pay(支払仕訳)を指定できます。会計側への登録が済んだら、PUT で journal_id_list に仕訳IDを最大1000件まで渡して出力済みの状態に更新してください。登録の成功を確かめる前に出力済みへ更新すると、失敗した仕訳が二度と未出力一覧に出てこなくなるので、更新は必ず会計側の登録結果を確認した後に行います。リトライと冪等性の組み方はAPI連携の実装方法|REST連携の5手順と認証・リトライをPythonで実装で詳しく扱っています。
勤怠管理のデータを外部へ渡す:APIの申込と連携方式A・Bの違いと手順
勤怠管理のAPI連携は、連携先サービスの画面から設定する形で提供されています。同じ勤怠SaaSでもKING OF TIMEは仕様書が公開されていて、アクセストークンで日別勤怠や打刻を直接取得できます(KING OF TIME APIの使い方)。マネーフォワード クラウド給与の公式ガイドでは、連携方式が「ジョブカン勤怠管理A」と「ジョブカン勤怠管理B(旧API利用)」の2つに分かれています。
ジョブカン勤怠管理Aとの連携では、利用者が事前にジョブカンのサポートページにある「APIお申し込みフォーム」から申し込み、連携画面で管理者ページのログインに使う「勤怠会社ID」を入力します。ジョブカン勤怠管理を無料プランで使っている場合はAPI連携を利用できません。取り込めるのは、ジョブカン側に初期値として登録されている勤怠項目(出勤日数、欠勤日数、遅刻回数、残業時間、深夜残業時間、有休使用日数、45時間超・60時間超の普通残業など)で、独自に作成した勤怠項目は取り込めません。
旧APIを使う連携Bでは、ジョブカン勤怠管理の「基本情報設定」から「他社システム連携」を開き、「APIキー表示」で出る接続文字列を連携先へ貼り付けます。これから新しく設定するなら、連携先がA方式に対応しているかを先に確かめ、Aを選びます。
自社開発の給与計算や原価管理のシステムへ勤怠データを渡したいときは、連携先サービスの画面が無いので、ジョブカンへAPIの利用を申し込み、提供される仕様と利用条件を受け取ってから設計します。申込の前に渡したい項目を列挙しておくと、提供範囲で足りるかを早い段階で判断できるためです。初期値の項目しか取れない前提が崩れる場合は、ジョブカンの勤怠データをCSVで出力して取り込む方式も比較に入れます。給与計算側で勤怠連携をどう比べるかは給与計算システムの比較|就業形態・社会保険・年末調整・勤怠連携の4軸で候補を絞る手順で、勤怠管理システムに求める機能そのものは勤怠管理システムとは?導入義務の有無・機能・費用と検討時の確認項目でまとめています。
自社システムとつなぐ設計:β版APIを本番で使うときの採用条件と見送る場面
公式ドキュメントは冒頭で「本APIはβ版のため、仕様変更の可能性があります」と明記しています。β版であることは使わない理由にはなりませんが、壊れても業務が止まらない置き方をすることが条件です。
採用してよいのは次のような処理です。人事システムからユーザー・グループ・役職を毎朝同期する処理、承認済みの仕訳を夜間に会計システムへ取り込む処理、申請の完了件数を集計して管理画面に出す処理。いずれも失敗したら翌日に再実行すれば済み、取り込みの前後で件数を突き合わせれば漏れを検知できます。
見送るのは、APIが止まると支払いや給与の確定が止まる処理を、このAPIだけに依存させる設計です。仕様変更で項目名や日時の形式が変わると、取り込みが黙って欠損する恐れがあります。こうした処理では、CSVの手動出力を代替経路として残し、APIの応答に想定外の項目や欠落があれば取り込みを止めて通知する検査を入れてください。連携する製品が3つ以上に増え、それぞれの仕様変更を追う手間が重くなってきたら、接続を部品として持つiPaaSも選択肢になります。比べ方はiPaaSとは?API・RPA・ETLとの違いと料金の数え方を参照してください。
ジョブカンの勤怠データと自社の基幹システムや給与計算をつなぐ設計、打刻データを使った独自の集計や原価管理の開発は、勤怠管理システム開発として要件の整理から相談を受けています。
よくある質問
ジョブカンのAPIは無料で使えますか?
経費精算/ワークフローAPIの公式ドキュメントには、APIそのものの料金の記載はありません。利用には製品の契約と管理画面でのトークン発行が前提になります。勤怠管理のAPI連携は、マネーフォワード クラウド給与の公式ガイドに、勤怠管理を無料プランで利用している場合は使えないと書かれています。
ジョブカン勤怠管理の打刻データをAPIで直接取得できますか?
確認できる範囲では、勤怠管理のAPI仕様書は一般公開されていません。連携先サービス経由で取り込める項目は、出勤日数や残業時間といった集計済みの勤怠項目が中心です。打刻1件ごとの時刻が必要なら、ジョブカンへAPIの利用を申し込む際に提供範囲を確認し、足りなければCSV出力での取り込みを検討します。
APIトークンはどこで発行しますか?
経費精算/ワークフローAPIのトークンは管理画面で発行します。発行したトークンは Authorization: Token ... の形式でリクエストヘッダに付けてください。トークンは管理者権限に相当するため、共有アカウントで発行したまま放置せず、担当者の変更時に再発行します。
APIから申請を新しく登録できますか?
2026年11月21日時点の公式ドキュメントでは、申請書は一覧と詳細の取得のみで、APIから申請を起こす操作はありません。外部システムで発生した申請をジョブカンのワークフローに載せたい場合は、ユーザーやマスタをAPIで整えたうえで、申請自体は画面から行う運用になります。
1時間5000回の上限を超えるとどうなりますか?
公式ドキュメントでは、1アクセストークンあたり1時間5000回を超えるとエラーになると説明されています。申請書の詳細を1件ずつ取得する処理は回数が膨らみやすいため、一覧で取れる項目で済ませる、取り込みを日次に分ける、リクエストの間隔を0.72秒以上空けるといった方法で回数を均します。
関連記事
- API連携の実装方法|REST連携の5手順と認証・リトライをPythonで実装【2026年11月】:外部APIを呼ぶ処理の共通設計
- API連携とは?仕組みとデータ連携・CSV連携・Webhookとの違い、選び方と導入判断:APIかCSVかの判断
- 勤怠管理システムとは?導入義務の有無・機能・費用と検討時の確認項目【2026年】:勤怠管理システムに求める機能
- 給与計算システムの比較|就業形態・社会保険・年末調整・勤怠連携の4軸で候補を絞る手順:勤怠データの受け手側の比較
- Webhookとは?読み方・仕組み・APIとの違いを実際のHTTPリクエストで解説:ポーリング以外の連携方式