Safie Developers 仕様変更のお知らせ

---

いつもSafie Developers（https://developers.safie.link/）をご利用いただきありがとうございます。来月のバージョンアップに伴い、仕様変更を予定しておりますので、事前にお知らせいたします。

変更予定日

2026年10月15日（木）を予定しています。

変更内容

Auth v2 APIの仕様変更

Safie DevelopersにおいてOpenID Connect（以降、OIDCと表記）に対応するため、Auth v2/のAPIの仕様を変更いたします。変更内容は以下の通りです。
なお、APIキー認証は対象外です。現在OAuth2.0認証方式をご利用のお客様は、本リリース後も特にお手続きいただくことなく、引き続きご利用いただけます。また、OIDCをご利用にならない場合も、本変更に伴うご対応は不要です。

1. Auth v2/ アクセストークン取得 [OAuth2 Authorization Code Flow]

リクエスト

• 任意のパラーメータを追加

2. Auth v2/ アクセストークンのリフレッシュ

リクエスト

• パラメータ「client_secret」が必須から任意へ変更。OIDCをご利用にならない場合は引き続き指定が必要となります
• 任意のパラーメータを追加

レスポンス

OIDCを利用時のみレスポンスにパラメータ「id_token」が追加になります。
【変更前】

HTTP/1.1 200 OK
Content-Type: application/json
{
　"access_token":"YOUR_ACCESS_TOKEN",
　"expires_in":604800,
　"refresh_token":"YOUR_REFRESH_TOKEN",
　"token_type":"Bearer"
}

【変更後】

HTTP/1.1 200 OK
Content-Type: application/json
{
　"access_token":"YOUR_ACCESS_TOKEN",
　"expires_in":604800,
　"refresh_token":"YOUR_REFRESH_TOKEN",
　"token_type":"Bearer",
　"id_token":"YOUR_ID_TOKEN"
}

3. Auth v2/ アクセストークン取得 [OAuth2 Authorization Code Flow]

リクエスト

• パラメータ「client_secret」が必須から任意へ変更。OIDCをご利用にならない場合は引き続き指定が必要となります
• 任意のパラーメータを追加

レスポンス

OIDCを利用時のみレスポンスにパラメータ「id_token」が追加になります。

【変更前】

HTTP/1.1 200 OK
Content-Type: application/json
{
　"access_token":"YOUR_ACCESS_TOKEN",
　"expires_in":604800,
　"refresh_token":"YOUR_REFRESH_TOKEN",
　"token_type":"Bearer"
}

【変更後】

HTTP/1.1 200 OK
Content-Type: application/json
{
　"access_token":"YOUR_ACCESS_TOKEN",
　"expires_in":604800,
　"refresh_token":"YOUR_REFRESH_TOKEN",
　"token_type":"Bearer",
　"id_token":"YOUR_ID_TOKEN"
}

AI-App SDK（JavaScript）対応

• Safie SDK(JavaScript)
  • AI-App APIと同じ機能をSDK(JavaScript)でもご利用いただけます

ご質問

上記の通り仕様変更を予定しています。お使いいただいている機能が変更されますので、ご注意くださいませ。

また変更内容に関する事前のご質問・お問い合わせについては、お問い合わせフォーム（https://safie.jp/contact/api/）よりご連絡ください。

お客様にご満足いただけるサービスを提供できるよう引き続き努めてまいりますので、今後ともよろしくお願い申し上げます。

——

セーフィー株式会社
Safie Developers サポート窓口
平日10:00～17:00（土日祝祭日、年末年始等を除く）

---