このページは英語から翻訳されています。
開発者向けツール
APIテスト・デバッグツールを構築する
すべてのエンドポイントを覚え、すべてのリクエストを再生し、パートナーAPIを予定どおりプローブする作業台。破壊的変更は加盟店のチェックアウトではなく、あなたのインシデントフィードに出ます。
テキスト ボックスにアイデアを入力するだけで、AIがそれを構築します。
共有リクエストコレクションは伸び止まる
統合が1つ、エンジニアが2人だったころは、各ノートPCのAPIクライアントで足りました。今は14の配送会社API、3つのタイムゾーンの3人の同僚、そして「送り状障害はそちらのバグか配送会社のデプロイか」と電話してくる加盟店がいます。答えは6つのエクスポート済みコレクション、Slackの長い履歴、3月の追跡ペイロードがどうだったかという誰かの記憶に散っています。
Klivは、代わりに作業台を記録システムとして構築します。すべてのエンドポイント、保存リクエスト、プローブ結果、インシデントが、チーム全体で共有するデータベースの行です。クエリでき、アクセス制御され、設定したエンジニアが休暇中でも残っています。チームがどうデバッグするかを説明してください。Klivはそれを覚えるツールを構築します。
リクエストの構成要素
5つのオブジェクト、1つの調査。作業台が保持するものと、それを正しく保つ仕組みです。
エンドポイント記録
環境ごとのベースURL、認証方式、パートナー側の連絡先、相手が持たないのでこちらで保守する変更履歴。すべてのリクエストとインシデントはこの記録にぶら下がります。
保存リクエスト
ヘッダー、本文、テストに変えるアサーション。期待ステータス、期待形状、レイテンシ上限。アサーションのないリクエストは、構文ハイライト付きの推測です。
プローブスケジュール
サーバー側関数がcronで保存リクエストを走らせます。ステージングは15分ごと、本番は毎時。アサーション失敗はインシデントを開き、成功はログするだけです。
インシデント
レスポンス差分、タイムライン、影響を受ける加盟店、誰にいつ伝えたか。記憶から障害を復元する代わりに、クライアントへ見せるものです。
パートナーの壁
エンジニアは割り当てられたパートナーを見ます。ステータスビューにサインインしたクライアントは自分の統合だけを見ます。他の行は単に配信されません。
静かなバージョン更新ひとつ
パートナーが金曜に公開し、誰にも知らせません。以前ならあなたの週末だったものを、作業台がどう過ごすか。
金曜、ヘッダーが増える
配送会社がステージングへデプロイします。メールも変更履歴もありません。木曜は2.13だったバージョンヘッダーが、2.14を示しているだけです。
土曜6時、プローブが違いを見つける
定期実行で、追跡ペイロードにフィールドが1つ増え、1つ消えたことが分かります。アサーションは形状で失敗します。エンドポイントはまだ200を返します。200は嘘をつきます。
差分付きでインシデントが開く
重大度はデータから来ます。この配送会社を通る加盟店がどれか。該当する2社は、誰かが起きる前にインシデント上で名前が出ています。
月曜、横並びで再生
保存リクエストをステージングと本番に対して1つのビューで走らせます。変更範囲は絞られ、修正はマッピング更新で、調査全体が1画面に収まります。
クライアントはタイムラインを読む
安心させるメールではありません。自分の統合に範囲が絞られたインシデントページです。何が変わり、いつ知り、何をしたか。信頼はリンクできるページになります。
APIに向ける
配送会社API作業台
配送パートナー向けの保存リクエスト、プローブ、インシデント。
“配送連携向けのAPIテスト作業台を作りたい。配送会社ごとの保存リクエスト、ステージングと本番への定期プローブ、レスポンス形状アサーション、差分とタイムラインを記録するインシデントを入れて。”
決済Sandbox監視
リリース前に決済パートナーのSandboxを見る。
“保存済み決済APIリクエストを毎時再生し、レスポンス形状とレイテンシを検証し、アサーションが失敗したら完全なレスポンス差分付きでインシデントを開く監視を作りたい。”
クライアントステータスポータル
各加盟店に自分の統合だけを見せる窓。
“各クライアントがサインインして自分の統合だけの稼働率、インシデント、プローブ履歴を見られ、インシデントの開始や解決時にメール更新を受け取れるステータスポータルを作りたい。”
コンソールの下
プローブは予定ジョブです。 各プローブはcron上の型付きサーバー側関数です。保存リクエストを再生し、アサーションを評価し、結果を行として書きます。ホストするものも、見守るランナーもありません。予定はアプリの一部です。
パートナーキーはサーバー側に残ります。 Sandbox環境と本番キーはプラットフォームが保存し、実行時に注入します。ノートPCへエクスポートされるコレクションファイルやWikiに貼られる場所にはありません。ステージングのプローブが本番キーで走ることは物理的にできません。
壁はビューではなく行です。 2社の配送会社に範囲が絞られたエンジニアは、全員と同じテーブルをクエリし、2社だけを受け取ります。パートナー別プライバシーは画面上のフィルターではなく、データの性質です。
これはデスクトップツールではなくアプリなので、クライアントが触れる面も育ちます。加盟店ごとのステータスページ、週次プローブ結果の月曜朝ダイジェスト、「料金APIが最後に変わったのはいつ？」に自分のインシデント履歴から答えるエージェント。誰かの記憶ではありません。
ここには対称性があります。作業台はパートナーに契約を守らせます。そしてKlivは、本物のテストを構築と一緒に書き、テスト成功を待つ公開ステップで、作業台自身に契約を守らせます。テスト機能がその規律を説明しています。
本番に向ける前に聞かれること
プローブは本番に損害を出さずに走れますか？
はい。本番で安全な保存リクエストをあなたが指定し、それだけが本番予定に入ります。書き込み型のリクエストはステージングに固定されます。各環境は自分のキーを持つので、テストが誤って本番キーを使うことはありません。
クライアントは作業台を見られますか？
範囲を絞った一部を見ます。自分の統合、インシデント、稼働率を並べるステータスビューです。データベースの行レベルルールで強制されます。同じテーブル、狭い水平線です。エンジニアには全コンソールがあります。
午前3時にアサーションが失敗したら？
レスポンス差分付きのインシデント行が作られ、オンコールエンジニアへあなたの文面でメールが届きます。Slackを接続していればチャンネルにも投稿されます。プローブは走り続けるので、回復のタイムラインも無人で記録されます。
すでにAPIクライアントにコレクションがあります。作り直しですか？
昇格です。保存済みリクエストはデータです。インポートすれば、周りにデータベースが付きます。予定、アサーション、インシデント、パートナー別アクセス。誰かのノートPC上のファイルではなくなります。
クリエイターが構築
可能性を探る
世界中の開発者とクリエイターが Kliv で構築した実際のアプリをご覧ください
Memory Café Coordination Tool
A warm platform for dementia-friendly cafés, connecting caregivers, volunteers, and coordinators.
Remit Record
Track remittances and household budgets seamlessly.
Next Page Book Club
Manage your book club easily with proposals, voting, and history tracking.
Northfern Tattoo Studio
Portfolio and booking site for Northfern Tattoo Studio.
Campo Agua Gestión
Sistema de gestión del agua comunitario para aldeas.
つくりて — 伝統工芸職人サイト
職人が作品を展示し、受注管理を行うサイトです。
Tidal Surf Reports
Crowd-sourced surf condition tracking app.
Riverside Commons HOA Management
A portal for HOA management at Riverside Commons.
よやくん — レストラン予約管理
小規模レストラン向けの予約管理サイトです。
Troop 214 Scout Management
A management tool for Scout Troop 214, focused on outings, advancement, and communication.
Te Kura Kaupapa Māori Whānau Board
A whānau coordination tool for Māori-medium schools.
Tsev Nyeem Ntawv Library
Mobile library coordinator for Hmong and Lao communities.
Memory Café Coordination Tool
A warm platform for dementia-friendly cafés, connecting caregivers, volunteers, and coordinators.
Remit Record
Track remittances and household budgets seamlessly.
Next Page Book Club
Manage your book club easily with proposals, voting, and history tracking.
Northfern Tattoo Studio
Portfolio and booking site for Northfern Tattoo Studio.
Campo Agua Gestión
Sistema de gestión del agua comunitario para aldeas.
つくりて — 伝統工芸職人サイト
職人が作品を展示し、受注管理を行うサイトです。
Tidal Surf Reports
Crowd-sourced surf condition tracking app.
Riverside Commons HOA Management
A portal for HOA management at Riverside Commons.
よやくん — レストラン予約管理
小規模レストラン向けの予約管理サイトです。
Troop 214 Scout Management
A management tool for Scout Troop 214, focused on outings, advancement, and communication.
Te Kura Kaupapa Māori Whānau Board
A whānau coordination tool for Māori-medium schools.
Tsev Nyeem Ntawv Library
Mobile library coordinator for Hmong and Lao communities.
加盟店より先にバージョン更新を捕まえる
チームがどうデバッグするかをKlivに伝えてください。パートナー、プローブ、壁。14個のAPIをすでに知っている作業台から始められます。
