1 イッチ 2025-11-04 10:30:15 ID:AIreadyDEV
最近出たPostmanの記事がおもろかったから共有するわ
これからのAPIはAIに使ってもらうことを意識せなあかんらしい
https://www.marktechpost.com/2025/11/02/how-to-create-ai-ready-apis/
Postman recently released a comprehensive checklist and developer guide for building AI-ready APIs, highlighting a simple truth: even the most powerful AI models are only as good as the data they receive—and that data comes through your APIs.
If your endpoints are inconsistent, unclear, or unreliable, models waste time fixing bad inputs instead of producing insight.
Unlike developers, Agents can’t compensate for messy docs or ambiguous behavior.
Humans can infer missing details from vague API docs, but AI agents can’t—they rely entirely on explicit, machine-readable metadata.
AIは人間みたいに「まあええか」で察してはくれんのやと
3 ぷろやきうのおにいちゃん 2025-11-04 10:31:02 ID:AbcdeFG1
長い。三行で
5 ぷろやきうのおにいちゃん 2025-11-04 10:32:18 ID:HIjklMN2
AIがAPIに文句タラタラで草
もう人間様いらんやん
8 イッチ 2025-11-04 10:33:45 ID:AIreadyDEV
＞＞3
AI「お前のAPIガバガバ」
AI「ドキュメントも意味不明」
AI「ワイはフリーズする」
12 ぷろやきうのおにいちゃん 2025-11-04 10:35:01 ID:oPqRsT3
＞＞8
分かりやすくて草
AIくんすぐフリーズする雑魚メンタルなんか
15 ぷろやきうのおにいちゃん 2025-11-04 10:36:22 ID:uvWXyZ4
これうちの義母と一緒やん
「アレ取って」とか指示が曖昧すぎてこっちがフリーズするわ
AIは義母だった…？
19 ぷろやきうのおにいちゃん 2025-11-04 10:38:13 ID:aBCdeF5
＞＞15
草。義母-readyなコミュニケーションは無理ゲー
エラーメッセージ返したら倍になって返ってくるしな
23 ぷろやきうのおにいちゃん 2025-11-04 10:40:57 ID:gHIjkL6
ワイデブ、APIのレスポンスもデブ
AIくん、重すぎてタイムアウトしそう
28 ぷろやきうのおにいちゃん 2025-11-04 10:42:30 ID:MnoPQR7
＞＞23
機械が消費可能なメタデータ（Machine consumable metadata）とは言うけど、お前のAPIはカロリー消費量が多すぎる
35 イッチ 2025-11-04 10:45:11 ID:AIreadyDEV
そうそう、エラーの返し方も重要らしい
「なんかエラー出たわw」じゃなくて、「こういう理由でエラーやで。こうすれば直るで」ってリッチなエラー情報を返さんとAIが自己修復できんのやと
41 ぷろやきうのおにいちゃん 2025-11-04 10:47:05 ID:StuVwX8
＞＞35
もう新人教育やん
手取り足取り教えなあかんのか
48 ぷろやきうのおにいちゃん 2025-11-04 10:49:19 ID:yZAbCDE9
ワイのAPI、大体500 Internal Server Errorしか返さんけどAIくん使ってくれるか？
55 ぷろやきうのおにいちゃん 2025-11-04 10:51:48 ID:fGHiJk0
＞＞48
門前払いやろ
「このAPIはやる気がありません」ってAIに見捨てられるで
62 ぷろやきうのおにいちゃん 2025-11-04 10:53:03 ID:LmNoPq1
結局これって、今まで「良い設計」って言われてたことを徹底しろって話よな
人間相手だと多少ガバくてもなんとかなってただけで
70 ぷろやきうのおにいちゃん 2025-11-04 10:55:27 ID:rSTuvW2
＞＞62
ほんこれ
命名規則を統一するとか、予測可能な挙動とか、当たり前のことばっかや
それができん奴が多すぎるんや
78 ぷろやきうのおにいちゃん 2025-11-04 10:58:14 ID:xyzABC3
デブにも義母にも新人にも分かりやすいAPIがAIにも好かれるんやな
はえ～勉強になるわ
85 イッチ 2025-11-04 11:00:00 ID:AIreadyDEV
せやな。AIエージェントが自律的にAPI叩きまくる未来が来るから、今のうちから備えとけってことやと思う
ワイらの仕事はAIの介護になるんかもしれん
92 ぷろやきうのおにいちゃん 2025-11-04 11:02:45 ID:DefGhi4
もうAPI設計書もAIに書かせた方がええやろ…
ワイはもう疲れたわ
イッチが投稿した「AIが使いやすいAPI」に関する海外記事をきっかけに、未来のAPI設計について住民たちが語り合うスレ。開発者の苦悩が垣間見え、なぜか義母やデブの話に脱線しつつも、AI時代の到来を実感する展開に。
AIという新たな「利用者」の登場により、これまで以上に厳密で分かりやすいAPI設計が求められる時代が到来する模様。住民たちは、自らの仕事や義母に思いを馳せながら、来るべき未来に備えるのであった。
参考URL:
[1] https://www.marktechpost.com/2025/11/02/how-to-create-ai-ready-apis/
