<p>いつもSmartHRをご利用いただきありがとうございます。</p><p>このたび、APIリクエストのクエリパラメータにアクセストークンを記載できない仕様に改修します。現在クエリパラメータにアクセストークンを記載している場合、下記「変更詳細」をご確認いただき、リクエストヘッダーに付与するように変更をお願いします。APIを使ったサービスをご利用いただいている場合、必ず以下の変更点をご確認、または開発担当者様へご共有の上、ご対応をお願いいたします。</p><p><em>※本お知らせは</em><a href="https://smarthr.jp/update/48171"><em>2023年2月、6月、10月のご案内</em></a><em>の再掲となります。ご対応が必要なお客さまには2023年10月16日(月)にメールにてご案内予定となります。メールを受け取っていないお客さまは、ご対応いただくことはございません。</em></p><h2 id="hcb45755ca6">ご対応いただきたいこと</h2><ul><li><strong>APIリクエストのURLにアクセストークンの記載がある場合は、リクエストヘッダーに付与するように、API連携プログラムの修正をお願いします。</strong><ul><li>現状の仕様で既にリクエストヘッダーにもアクセストークンの付与が可能です。</li><li>期日内でにご対応がいただけない場合、API連携が正しく挙動せず運用に影響がでてしまう可能性がございます。</li><li>ご不明点・ご相談等がある場合はチャットサポートもしくは担当カスタマーサクセスもしくはお問い合わせフォームまでご連絡ください。</li></ul></li></ul><h3 id="hf5c212b558">＜連携方式について＞</h3><ul><li>自社開発にてSmartHRのAPIを利用している場合<ul><li>開発のご担当者さま、もしくは開発パートナーさまに共有いただきご確認・ご対応お願いします。</li></ul></li><li><a href="https://support.smarthr.jp/ja/help/articles/360026105974/">SmartHRと連携しているサービス一覧</a>と連携している場合<ul><li>サービス側で期日までの対応を行うため、お客様側でのご対応いただくことはございません。</li></ul></li><li>上記に記載がないサービスでAPIをご利用の場合<ul><li>サービス提供企業へ本お知らせを共有いただきご確認いただき、必要に応じてご対応をお願いします。</li></ul></li></ul><h2 id="ha056e7cefe">変更時期</h2><p><s>2023年10月31日（火）23時に変更を行います。</s><br>【2023年11月1日追記】 10月31日（火）23時に作業完了いたしました。</p><h2 id="hdd0dad5bcc">変更背景</h2><p>APIリクエストのクエリパラメータにアクセストークン付与はセキュリティ上の懸念があるため。</p><h2 id="h3b974f0f41">変更詳細</h2><p>APIリクエストのクエリパラメータにアクセストークンを付与できない仕様に変更します。</p><h3 id="hb64cb6ee56">例： 従業員情報の取得</h3><h4 id="h32087357d3">現在</h4><ul><li>GET https://{subdomain}.smarthr.jp/api/v1/crews/{id}<em>?access_token={access_token}</em><ul><li>アクセストークンをクエリパラメータとして付与可能でした。</li><li>また現時点でのリクエストヘッダーでの付与も可能です。</li></ul></li></ul><h4 id="h53f04a8d34">変更後</h4><ul><li>GET https://{subdomain}.smarthr.jp/api/v1/crews/{id}<ul><li>アクセストークンをクエリパラメータとしての付与を禁止します。</li><li>リクエストヘッダーにてアクセストークンを付与するよう変更をお願いします。</li></ul></li></ul><p>こちらの<a href="https://developer.smarthr.jp/api/index.html#!/overview/authorization">SmartHR APIのドキュメントにある「認証」</a>もご参考ください。</p><h2 id="h3bcda3e6b0">最後に</h2><p>SmartHRでは、ご利用企業の声を積極的にサービス開発の参考にしていきたいと考えております。機能や画面のデザインなど、なにか気になることがございましたら、お気軽にお伝えください。</p><p>SmartHRの機能追加、改善に関する情報は「アップデート情報」や「リリースノート」にて、株式会社SmartHRの企業情報に関するニュースはFacebook・X（旧Twitter）からもお知らせしています。</p><p>よろしければ「いいね！」「フォロー」をお願いします。</p><ul><li><a href="https://smarthr.jp/update">お知らせ</a></li><li><a href="https://knowledge.smarthr.jp/hc/ja/categories/360004438553?_ga=2.81550226.407776416.1639365461-1044674420.1627633649&amp;_gac=1.149314884.1638332231.Cj0KCQiAtJeNBhCVARIsANJUJ2GzXPgWcy-_DVzIhzpDVfTxerb7Q2gl8kmudpxemSYGOFA4oMYU-rIaAhwdEALw_wcB">リリースノート</a></li><li><a href="https://www.facebook.com/smarthrjp/">Facebookページ</a></li><li><a href="https://twitter.com/smarthr_jp">X（旧Twitter）</a></li></ul><p>今後とも、SmartHRをよろしくお願いいたします。</p>

APIリクエストのクエリパラメータにアクセストークンを記載できない仕様に改修します（10/31更新）

SSO／SAML認証

文書配付

人事労務レポート

従業員サーベイ

人事評価

配置シミュレーション

キャリア台帳

学習管理

採用管理

通勤経路検索

有料オプション

設定

従業員リスト・従業員情報

招待

マイナンバー

手続き

電子申請

届出書類

給与明細

源泉徴収票

お知らせ管理

年末調整

従業員情報申請

組織図・名簿

スキル管理

HRアナリティクス

データ連携

各種サービス連携

機能で調べる

セキュリティ

SmartHR API

料金と契約内容

サポート

その他