メインコンテンツまでスキップ

開発者向けSDK/API概要

1. SaaSus SDK / API の提供機能と利用用途

ドメイン主な用途
Auth APIID・アクセストークン取得、ユーザー / テナント管理、ロール・属性設定
Billing APIStripe 連携設定
Pricing API料金プラン・税率・メータリングの設定
Communication APIユーザーフィードバックの送信・取得
Apilog APIAPI 呼び出しログの取得
Awsmarketplace APIAWS Marketplace 連携設定
Integration APIAmazon EventBridge 連携設定
ApiGateway APISmart API Gateway 設定

2. 認証情報の取得と利用方法

SaaSus API では すべてのリクエストで SAASUSSIGV1 署名ヘッダーが必須です。以下のフローで署名を生成し、ID トークン(id_token)を取得・利用します。

2.1 署名ヘッダー SAASUSSIGV1 の作り方

署名アルゴリズムはGetting Started にまとまっています。ここでは最低限のフォーマットだけ示します。

Authorization: SAASUSSIGV1 Sig=<署名>, SaaSID=<SaaS ID>, APIKey=<API Key>

SDK を利用する場合

  • SDKは リクエスト送信前に署名ヘッダーを自動付与します。
  • ユーザー側で Sig を生成するコードを書く必要はありません。

2.2 ID トークン (id_token) の取得と利用

  1. 署名付きで GET /v1/auth/credentials を呼び、id_tokenclient_idclient_secret を取得します。
  2. id_tokenJWT 形式。ブラウザの localStorage などに保存します。
  3. ユーザー情報 API (GET /v1/auth/user-info など) で id_token をパラメータとして渡します。
# 1) id_token の取得(`code` を使う場合)
TEMP_CODE="69e732d6-8ecc-45c4-c2eb-8438f7ffe775"
curl https://api.saasus.io/v1/auth/credentials?code=${TEMP_CODE} \
-H "Authorization: SAASUSSIGV1 Sig=..., SaaSID=..., APIKey=..."
備考

一時コード code はログインリダイレクト時にクエリパラメータとして渡されます。

SDK 例は JWT 取得 API 実装例 を参照。

# 2) id\_token を使ったユーザー情報取得
curl https://api.saasus.io/v1/auth/userinfo?id_token=<ID_TOKEN> \
-H "Authorization: SAASUSSIGV1 Sig=..., SaaSID=..., APIKey=..."

SDK 例は ユーザー情報取得 API 実装例 を参照。

3. 代表ユースケース別リンク集

ユースケースAPI リファレンス学習用リンク
テナント作成Auth API – CreateTenantテナントの作成
ユーザー作成Auth API – CreateSaasUserSaaSにユーザー作成機能が実装されているケースの実装
メータリング関連Pricing API – metering タグ一覧メータリングAPIの実装サンプルと使用例(Laravel)

4. SDK リスト

言語SDK リンク
PythonPython SDK GitHub
JavaScriptJavaScript SDK GitHub
GoGo SDK GitHub
JavaJava SDK GitHub
PHPPHP SDK GitHub
C#C# SDK GitHub