Developer

マイクロSaaS APIマーケットプレイス

半日で、APIを公開し、計測し、収益化する。

マイクロSaaS APIマーケットプレイス is api 収益化 for teams that want the reasoning shown, not hidden. Plans start at $29 a month with a 14-day free trial.

無料トライアルを始める

APIを公開するのは簡単な半分です。難しい半分は周りにあります。鍵の管理、利用量の計測、流量制限、従量課金、そして古びない文書です。APIマーケットプレイス一式はその層を用意します。一年前から出来上がっている接続口を売るために、三か月を基盤構築に費やさずに済むようにするためです。

鍵、割当、流量制限

利用者ごとに固有の範囲を持つ鍵を発行し、停止なしで差し替えられます。新しい鍵を古い鍵と並べて有効にしておき、移行が終わるまで待てます。当たり前に見えて、自作の仕組みでたいてい欠けている部分です。

流量制限は鍵ごと・接続口ごとのトークンバケットとして動き、持続的な上限より高い一時的な余裕を持ちます。決定的なのは応答ヘッダーです。残りの割当、再開の時刻、そして429のときの `Retry-After`。これらのヘッダーがなければ利用者側は礼儀よく振る舞えず、結果として無限の再試行で戻ってきます。

鍵ごとの範囲: アカウント単位ではなく鍵単位の権限。鍵が漏れたときの被害を限定します。
トークンバケットによる制限: 持続上限と一時的な余裕を、鍵ごと・接続口ごとに。割当ヘッダーを完備します。
利用量の計測: 呼び出しごとの計数を冪等に記録します。再試行で二重に課金されません。
生きた文書: OpenAPI定義から生成し、試験環境に対して実行できる例を添えます。

帳尻の合う従量課金

従量課金が難しくなるのは、計測と課金が食い違う場所です。時間切れの後に再送された呼び出しを二度数えてはいけません。御社側のサーバー異常はまったく数えてはいけません。そして顧客が見る計数器は、請求書に載るものと同じでなければなりません。

ここでの計測は呼び出し識別子に対して冪等で、5xx応答を除外し、ちょうど一つの計数器を更新します。その計数器を顧客向け画面と請求処理の両方が読みます。段階価格、無償枠、最低額はすべてその単一の計数器の上で計算されます。

版の管理と廃止予告

十分に長く生きたAPIはすべて二つ目の版を持ち、その移行こそ提供者が利用者を失う場所です。ここでは版を経路に持たせ、並行運用し、廃止の予定をメールに出る前に応答ヘッダーで見えるようにします。

併せて版ごとの利用状況が出ます。どの利用者がまだ旧版にいて、どれだけの量を使っているかが見えるので、停止の判断を数字に基づいて下せます。顧客三者が日に十回呼ぶ接続口は、全体の半分の通信量がある接続口とは別の話です。

流量制限と計測の組み合わせ

流量制限と課金は同じ出来事を読みますが、異なる判断を下します。順序が重要で、ここでは固定されています。

鍵と範囲を確かめる認証と権限確認が何よりも先です。拒否された呼び出しは割当を消費せず、課金もされません。
割当を照会する鍵のトークンバケットを確認します。足りなければ Retry-After を伴う429を返し、呼び出しは御社の処理に届きません。
要求を実行する呼び出しが御社のサービスへ渡り、処理時間と状態コードが記録されます。
成功時のみ課金対象として数える5xx応答は記録しますが課金しません。御社側の障害は提供された役務ではありません。
冪等に記録する計数は呼び出し識別子に対して行うので、同じ識別子での再試行が計数器を再び動かすことはありません。

四番目の段階は見落とされがちで、どんな価格設定よりも早く信頼を損ないます。御社のサーバー異常で終わった呼び出しに対して払った顧客は、次回は請求書を一行ずつ確認します。そしてそのとき他のすべても見つけます。

こんな方に

APIを公開するSaaS

「社内APIがある」から「顧客が代金を払える」までの最短経路。課金の層を自前で作らずに済みます。

データ提供者

段階と無償枠を伴う従量課金がそのまま製品であり、信頼できる計数器がその前提です。

社内基盤チーム

課金なしで同じ層を、チームごとの割当とともに使います。隣のチームに意図せず押し潰される社内サービスがあるときに有用です。

APIの二つ目の版を持つチーム

版ごとの利用状況と見える廃止予告のヘッダーが、危うい停止を計画された手順に変えます。