3Min APIを作った理由 — 一本の電話から始まった物語

こんにちは、3Min APIで開発者体験（DX）を担当しているチェウォンです。

このサービスを作る前、私は長い間ほかのチームのバックエンドを代わりに作る仕事をしていました。そうしているうちに、ほぼ予測可能なレベルで繰り返される依頼がひとつありました。

「うちは開発チームがないんですが、取引先が販売データをAPIで連携したいと言っていて。手伝ってもらえますか？」

小さなECサイトの会社、社員5人の物流スタートアップ、大きなパートナーを獲得したばかりのマーケティングエージェンシー。会社は違っても、問題の形は常に同じでした。

自社バックエンドがなく、作れる人もいない。でも取引先 — たいていはずっと大きな会社 — がプログラム的にデータを送りたがっている。メールにExcelを添付する方法では、もう通用しない時代ですから。

繰り返されるサイクル

そこで素早くバックエンドをひとつ作ります。シンプルに — JSONを受け取って、保存して、基本的な管理画面をひとつつける程度。デプロイして、APIドキュメントを渡して、完了。

でも数ヶ月後にまた連絡が来ます。

「新しい取引先ができたんですが、そちらも連携したいそうです。データ形式がちょっと違うんですけど。」

振り出しに戻る。新しいエンドポイント、新しいスキーマ、新しい管理画面。またテスト、またデプロイ。また費用。

こうした一度きりのプロジェクトが積み重なると、データが散らばり始めます。最初の連携はこのサーバー、2番目はあのサーバー。何が入ってきているのか一目ではわからない。テスト環境はめちゃくちゃか、そもそもない。しかもこれだけ苦労した割に、実際の利用は月に数百コールだけということもありました。かけたコストと時間がもったいないほどに。

このパターンを何年も見てきました。1社ではなく、何十社もで。同じ苦しみ、同じ無駄、同じ繰り返し。

思った以上に深刻な問題

変化の速い市場において、こうした摩擦は単なる不便ではなく、実質的な弱点です。ひとつの連携をセットアップするのに数週間かかっている間に、競合はすでにデータを受け取り始めているのですから。

小規模チームには、新しいパートナーが来るたびにインフラをゼロから作り直す余裕はありません。素早く連携し、ビジネスになるか確認し、売上が出ればそこからスケールするのが合理的です。

素早く連携し、素早く学び、準備ができたらスケールする。完全に合理的な戦略です。しかし当時利用できるツールは、このアプローチをサポートしていませんでした。ほとんどが開発チームがいることを前提に設計されていたのです。

足りないと感じたもの

同じ疑問が頭の中をぐるぐる回っていました。数週間ではなく数分でAPIエンドポイントをセットアップできたらどうだろう？

最近のシステムのほとんどはJSONで通信しています。それが現実です。であれば、どうせJSONなのに、なぜリレーショナルデータベースのスキーマを先に定義しなければならないのでしょう？受け取りたいデータの形を記述するだけで、すぐに受信を開始できればいい。NoSQLに近いコンセプト — 柔軟で、セットアップが速く、変更が簡単。

しかしデータを受け取ることは半分に過ぎません。多くのチームが、入ってきたデータを自社のデータベースやCRM、スプレッドシートなど既存のツールに転送したがっていました。そこでWebhookを実装しました。データが届くと、必要な場所に自動転送される仕組みです。

何かが壊れるまで気づかないこと

本番環境で運用が始まると、信頼性がすべてです。サーバーに問題が起きたからといってデータが消えてはいけません。そこでリトライロジックとリカバリ機能を作りました。問題が発生しても最大56時間データが保持されるため、何も失わずに問題を解決する時間が生まれます。

障害アラートも実装しました。連携が切れたりWebhookが失敗したりすると、すぐに通知が届きます。些細なことに聞こえるかもしれませんが、専任のオペレーションエンジニアがいないチームにとっては本当に重要です。問題を数分で発見するか、数日後に取引先から電話が来てから気づくかの違いですから。

そしてもう少し地味なニーズもあります。連携が時間とともにどう推移しているかを示す統計機能 — コール数、トレンド、成長率を確認できます。アーカイブ機能ではデータをJSONLファイルとしてダウンロードして、オフラインで分析したりマイグレーションに使ったりもできます。華やかな機能ではありませんが、ビジネスを理解しようとするとき、本当の違いを生むものです。

今は

最近、同じような依頼が来ると — 「APIが必要だけど開発チームがない」 — まず3Min APIをご案内しています。営業トークではなく、その会話の反対側に何度も立ってきたからこそ、その大変さがわかるのです。

すべての問題を解決するわけではありません。複雑なビジネスロジックや深いカスタマイズが必要なら、いずれ卒業する時が来るかもしれません。それでいいのです — それが本来の姿です。今日動くものから始めて、準備ができたら次のステップを考えればいい。

もしこの話が身に覚えがあるなら — 一度きりのバックエンドと散らばったデータの繰り返しを経験してきたなら — 一度ご覧になってみてください。私たちが必要としたから作ったのです。もしかしたら、あなたにも必要かもしれません。

3Min APIが自分の状況に合うか気になったら — ChatGPT、Gemini、Claudeにhttps://3minapi.com/llms-full.txtと一緒に聞いてみてください。一緒に考えてくれますよ。