{"article":{"id":4750419479710,"url":"https://josys1.zendesk.com/api/v2/help_center/ja/articles/4750419479710.json","html_url":"https://jpsupport.josys.com/hc/ja/articles/4750419479710","author_id":4631784684190,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":4750207142174,"created_at":"2025-04-23T17:10:31Z","updated_at":"2026-10-15T08:04:46Z","name":"Josys APIを利用する","title":"Josys APIを利用する","source_locale":"ja","locale":"ja","outdated":false,"outdated_locales":[],"edited_at":"2026-10-09T07:15:06Z","user_segment_id":null,"permission_group_id":4812048513310,"content_tag_ids":[],"label_names":[],"body":"<nav class=\"block-color-gray table_of_contents\"><div class=\"table_of_contents-item table_of_contents-indent-0\"><a class=\"table_of_contents-link\" href=\"#169e1fbe-8112-8088-b913-d976e18ce90b\">概要</a></div>\n<div class=\"table_of_contents-item table_of_contents-indent-0\"><a class=\"table_of_contents-link\" href=\"#169e1fbe-8112-802b-8d74-c27be8822241\">ご利用いただけるお客様</a></div>\n<div class=\"table_of_contents-item table_of_contents-indent-0\"><a class=\"table_of_contents-link\" href=\"#bb05f4d0-053b-436c-91e1-a29c5def0ec3\">IDトークン（APIキー）の発行方法</a></div>\n<div class=\"table_of_contents-item table_of_contents-indent-0\"><a class=\"table_of_contents-link\" href=\"#93c692b6-f8cd-4547-b59c-562bc9f7093c\">主要SaaSとのAPI連携手順</a></div>\n<div class=\"table_of_contents-item table_of_contents-indent-0\"><a class=\"table_of_contents-link\" href=\"#169e1fbe-8112-8086-b8b3-d04af605ce80\">注意事項</a></div></nav><h2 id=\"169e1fbe-8112-8088-b913-d976e18ce90b\">概要</h2><div class=\"tips\">\n<span class=\"icon\">💡</span> Josysでは、APIを公開しています。本機能を利用することで、APIを活用して自動でJosysに外部データを取得すること、Josysのデータの取得が可能となります。</div><p>利用方法の詳細については、<a href=\"https://developer.josys.com/docs/ja/kzinidl39fpjk-overview\">APIドキュメント</a>（Josys APIの仕様についてのドキュメント）をご確認ください。</p><h2 id=\"169e1fbe-8112-802b-8d74-c27be8822241\">ご利用いただけるお客様</h2><p>ご契約のすべてのお客様でご利用いただけます。</p><h2 id=\"bb05f4d0-053b-436c-91e1-a29c5def0ec3\">IDトークン（APIキー）の発行方法</h2><ol>\n<li data-list-item-id=\"e403eee5c6e32a6acdf4fa38c2ded87f1\">\n<code>メニュー　＞　デベロッパー　＞　REST API</code>をクリック。右上の「作成」ボタンをクリックする。<br><a href=\"https://jpsupport.josys.com/hc/article_attachments/4750366655390\"><img src=\"https://jpsupport.josys.com/hc/article_attachments/4750366655390\" width=\"2391\" height=\"1023\"></a>\n</li>\n<li data-list-item-id=\"e4534561d318e9424a1d5535cb9ee64e0\">ラベル名を入力後、「作成」ボタンをクリックする。<br><a href=\"https://jpsupport.josys.com/hc/article_attachments/4750366655518\"><img src=\"https://jpsupport.josys.com/hc/article_attachments/4750366655518\" width=\"2412\" height=\"1023\"></a>\n</li>\n<li data-list-item-id=\"e7759124e55e6907fdfcee6b511d75e70\">「APIユーザーキー」と、「APIシークレットキー」が表示されるので、コピーし保存をする。<br><a href=\"https://jpsupport.josys.com/hc/article_attachments/4750419479454\"><img src=\"https://jpsupport.josys.com/hc/article_attachments/4750419479454\" width=\"1866\" height=\"850\"></a>\n</li>\n</ol><div class=\"attention\">\n<span class=\"icon\">⚠️</span> 「<strong>APIシークレットキー</strong>」は再表示が出来ないため、必ず保管をお願いいたします。</div><h2 id=\"93c692b6-f8cd-4547-b59c-562bc9f7093c\">主要SaaSとのAPI連携手順</h2><p>連携手順については下記をご確認ください。</p><ul class=\"bulleted-list\">\n<li data-list-item-id=\"e4432ea7f8f9e45ad69ea94a22bbc1c9d\"><a href=\"https://jpsupport.josys.com/hc/ja/articles/4752301046558\">freee人事労務</a></li>\n<li data-list-item-id=\"ecb26afe56d379cca4ae1f64024286812\"><a href=\"https://jpsupport.josys.com/hc/ja/articles/4752289572638\">Jamf Pro</a></li>\n</ul><h2 id=\"169e1fbe-8112-8086-b8b3-d04af605ce80\">注意事項</h2><div class=\"attention\">\n<span class=\"icon\">⚠️</span><strong>Josys API（v1）は、2025年2月末にて提供を終了しました。</strong><br><br>API（v2）ではAPIのエンドポイント、ステータスのカラム名の表記が変更となっております。旧API（v1）をご利用のお客様はプログラムの修正をお願いいたします。<br><br><strong>エンドポイント</strong><br>新バージョン（v2）<br><a href=\"https://developer.josys.it/api/v2/user_profiles\"><code>https://developer.josys.it/api/v2/user_profiles</code></a><br><br><strong>在籍ステータスのカラム名</strong><br><a href=\"https://jpsupport.josys.com/hc/article_attachments/4750419479582\"><img src=\"https://jpsupport.josys.com/hc/article_attachments/4750419479582\"></a>\n</div>"}}