> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Public APIを使用する

> 取得したデータを自由に活用できるようPublic APIを公開しています。

取得したデータを自由に活用できるようPublic APIを公開しています。

提供しているPublic APIの詳細は[ドキュメント](/api-reference/it-management)をご参照ください。

**設定** > **APIキー一覧**の「APIドキュメント」からもご確認いただけます。

<img src="https://mintcdn.com/admina-sbn/XabUVJVnTdjaXr7n/images/it-management/cw1ivgng0g/2025-09-03-8-38-12.png?fit=max&auto=format&n=XabUVJVnTdjaXr7n&q=85&s=66a60852ca4f87807fd9a18b7f2f77d6" alt="APIドキュメント画面" width="2574" height="478" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-38-12.png" />

<h2 id="organization-id">
  OrganizationIDの確認
</h2>

**設定** > **APIキー一覧**の **組織ID** が**OrganizationID**となりますのでコピーしておきます。

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/cw1ivgng0g/2025-09-03-8-46-13.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=8a4e137c23060ba43ca7ca5c3f651cdc" alt="OrganizationID確認画面" width="1298" height="312" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-46-13.png" />

## Public APIでOrganizationIDを設定する

Public APIでPath Params > **organizationId**を設定する場合、[上記](#organization-id)でコピーした値を入力します。

<img src="https://mintcdn.com/admina-sbn/XabUVJVnTdjaXr7n/images/it-management/cw1ivgng0g/2025-09-03-13-11-12.png?fit=max&auto=format&n=XabUVJVnTdjaXr7n&q=85&s=01dc9ccdd49ac3ff5f02e809417d0412" alt="organizationId設定画面" width="1244" height="180" data-path="images/it-management/cw1ivgng0g/2025-09-03-13-11-12.png" />

<h2 id="generate-api-key">
  APIキーの発行
</h2>

1. 設定 > APIキー一覧　から、\[**APIキーを生成する**]ボタンをクリックします。

2. 「APIキーの生成」画面でAPIキー名に任意の名前を入力し、［生成する］をクリックします。

   <img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/cw1ivgng0g/2025-09-03-8-52-59.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=931a711175997548da466cc818af1dd3" alt="APIキー生成画面" width="732" height="454" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-52-59.png" />

3. APIキーが発行されますので、コピーして保存します。
   ※Public APIを実行するために必要です。一度しか表示されませんので、ご注意ください。

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/cw1ivgng0g/2025-09-03-8-48-51.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=648a4fc25eb1b58cb0d6952c96545b22" alt="APIキーコピー画面" width="2554" height="812" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-48-51.png" />

## Public APIでAPIキーを設定する

Public APIでCredentials > Bearerを設定する場合、[上記](#generate-api-key)でコピーした値を入力します。

<img src="https://mintcdn.com/admina-sbn/XabUVJVnTdjaXr7n/images/it-management/cw1ivgng0g/2025-09-03-13-17-02.png?fit=max&auto=format&n=XabUVJVnTdjaXr7n&q=85&s=f9d307ec49bf93e66e41ff3fd249bb9e" alt="Bearer設定画面" width="900" height="158" data-path="images/it-management/cw1ivgng0g/2025-09-03-13-17-02.png" />

## サービスIDを確認する

"serviceId"：サービス > 対象のSaaS（Githubなど）> サービス ID から確認できます。

<img src="https://mintcdn.com/admina-sbn/SGaLkLAYjRKTTbC4/images/it-management/cw1ivgng0g/2026-07-09-9-09-00.png?fit=max&auto=format&n=SGaLkLAYjRKTTbC4&q=85&s=63850796c0d4f10df50f5ec34bc90779" alt="サービスID確認画面" width="696" height="432" data-path="images/it-management/cw1ivgng0g/2026-07-09-9-09-00.png" />

## Public APIでエラーが表示される場合

Public APIをご利用中にエラーが表示される場合、以下を記載の上、サポートにお問い合わせください。

お問い合わせ方法は[サポートへのお問い合わせ](/it-management/changelog/3e6sz4xzsx-support)もご参照ください。

* ご利用のPublic APIの名称またはURL
* エラー詳細をご記載ください。

## FAQ

### Q. APIは日本語に切り替えできないのでしょうか？

A. UI上では言語の切り替えに対応しておりませんので、ブラウザ側の言語切り替えでご確認をお願いします。

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/cw1ivgng0g/2025-11-07-9-31-08.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=2285c1d22edbec1e17ef1818474d223e" alt="言語切り替え画面" width="572" height="246" data-path="images/it-management/cw1ivgng0g/2025-11-07-9-31-08.png" />

### Q. APIのカスタム項目での「Field ID Name」の設定・編集のルールはありますか？

A. カスタム項目の入力項目名には`小文字の英数字と_（アンダースコア）`のみ使用可能です。

カスタム項目の設定については、[デバイス](/it-management/device/2gdbiob664-device-itme#カスタム項目を追加する)と[ディレクトリ](/it-management/directory/gqqdb2621q-edit-uid#add-custom-fields)の各ヘルプページもご参照ください。

### Q. APIで登録時間を指定する事はできますか？

A. APIでは、 `createdAt` パラメータで**日付**、**時**、**分**を指定できます。

### Q. APIで取得したデータの時刻が、管理画面の表示と一致しません。なぜですか？

A. Public APIでは、すべてのタイムスタンプを「UTC（協定世界時）」で統一しているためです。管理画面（UI）では、ローカルタイムゾーン（例：日本標準時/JST）で時刻を表示しています。一方で、APIはシステム間の連携を確実にするため、世界共通の基準であるUTCを使用します。

### Q. APIから取得した時刻を日本時間（JST）に直すにはどうすればよいですか？

A. お客様側で、UTCからローカルタイムゾーンへの変換処理をお願いします。APIから送受信される日付文字列は、すべてUTCとして解釈されます。例えば、日本時間（JST）はUTCより9時間進んでいるため、APIで `00:00:00Z` となっている場合は、日本時間では `09:00:00` となります。

### Q. APIでデータを送信（POST/PATCH）する際、タイムゾーンはどう指定すべきですか？

A. 常にUTCとして送信してください。Public APIは、送られてきた日付文字列を常にUTCとして解釈し、システムに保存します。ローカル時間をそのまま送信すると、意図しない時刻で登録される可能性があるため、必ず変換してから送信してください。