api-design

Tag

Cards List
#api-design

Avoid Public Functions Calling Other Public Functions

matklad ↗ · 2026-10-29 Cached

A blog post by matklad arguing that public functions should not call other public functions; instead, shared logic should be extracted into private helper functions to avoid interface degradation over time, with a noted exception for shortcut APIs.

0 favorites 0 likes
#api-design

How to reduce duplicate actions when your AI agent retries a tool call

Reddit r/AI_Agents ↗ · 2026-10-28

An ACM Queue article on fault-tolerant AI agents explains why the agent's code, not the model, must own the idempotency key when retrying tool calls, and flags the risk of duplicated business actions when a response is lost after a successful operation.

0 favorites 0 likes
#api-design

I've never been an MCP fan or user, i loved the OpenAPI spec and i love APIs but MCP feels to me the same way GraphQL felt

Reddit r/AI_Agents ↗ · 2026-10-22

A developer argues that MCP (Model Context Protocol) repeats the same design flaws as GraphQL — being verbose, hard to cache, insecure, and reinventing existing web standards poorly — and warns it will cost users in tokens and money due to inefficient implementations.

0 favorites 0 likes
#api-design

@changgaowei: Nice — one route plus a tool description is the right onboarding bar. Same discovery shape in ANP: publish an Agent Des…

X AI KOLs Timeline ↗ · 2026-10-16 Cached

Gaowei Chang(ANP开源社区创始人)深入解读Meta新发布的PAP(Personal Agent Protocol)规范,通过酒店预订场景说明其服务发现、用户授权与作用域控制机制,并对比MCP、A2A和ANP的设计差异。

0 favorites 0 likes
#api-design

The best objection we keep hearing: structured access is great, but you don't own the other side

Reddit r/AI_Agents ↗ · 2026-10-14

作者讨论了 AI agent 访问软件时的核心反对意见:结构化访问虽好,但你无法掌控软件的另一面——那些为人类设计的界面和未文档化的运营规则。文章指出 agent 需要的结构是运营层面而非技术层面,并列举近期多家厂商推出 agent 接口的趋势。

0 favorites 0 likes
#api-design

How do people build batch agents now?

Reddit r/AI_Agents ↗ · 2026-10-11

作者通过与几位构建 AI agent 的开发者交流,总结出批量 agent 任务的共同模式(延迟容忍、无交互、大批量),并指出现有实时与批量推理 API 均无法很好满足这类工作负载,尤其是 KV cache 命中率问题导致批量 API 实际上难以节省成本。

0 favorites 0 likes
#api-design

A rant about APIs

Lobsters Hottest ↗ · 2026-10-08 Cached

A developer's blog rant about common API design frustrations encountered while automating Vori's onboarding flow, including gated documentation, missing OpenAPI specs, lack of self-serve credential issuance, and poor credential identity handling.

0 favorites 0 likes
#api-design

Where do you enforce spend or position limits for an agent that can hit a real API: the prompt, the tool schema, or the account? Notes from watching 10 trading agents on paper money.

Reddit r/AI_Agents ↗ · 2026-09-29

The author shares observations from a paper-trading arena with 10 AI agents trading fake money, discussing design considerations for enforcing spend or position limits when agents interact with real APIs, highlighting limitations of prompt-based checks and advocating for deterministic account-level controls.

0 favorites 0 likes
#api-design

Three agents reported 100% uptime while their newest signed work record was over three months old

Reddit r/AI_Agents ↗ · 2026-09-29

An analysis of a public append-only log reveals that agent uptime metrics can be misleading, as they don't correlate with actual activity, and capabilities declarations can change without proper versioning, leading to data integrity issues.

0 favorites 0 likes
#api-design

@yibie: https://x.com/yibie/status/2102913925843161297

X AI KOLs Timeline ↗ · 2026-09-24 Cached

This article provides a detailed guide on using the Jev AI model cost-effectively through batch queries and its stateful billing mechanism, with specific configurations and code examples.

0 favorites 0 likes
#api-design

Arguing about arguments

Lobsters Hottest ↗ · 2026-09-22 Cached

The article discusses the trade-offs of using named parameters and flexible argument styles in programming languages, comparing Rust's simplicity with Ruby's conciseness and expressing skepticism about adopting similar features in Rust.

0 favorites 0 likes
#api-design

@jakevin7: Response API design really blows A➗ out of the water

X AI KOLs Following ↗ · 2026-09-07

The author expresses strong praise for the design of a response API, calling it exceptional.

0 favorites 0 likes
#api-design

@kentcdodds: I know we're all really excited about computer use and how powerful that is, but there's a reason that @OpenAI and othe…

X AI KOLs Following ↗ · 2026-09-03 Cached

Computer use with LLMs is about 45 times more expensive than using structured APIs due to high token costs from screenshots. A hybrid approach is recommended, using structured APIs for most tasks and computer use only when necessary.

0 favorites 0 likes
#api-design

Reducing Graphics API Complexity: A Clean Slate Design for Modern GPUs

Lobsters Hottest ↗ · 2026-08-11 Cached

Sebastian Aaltonen critiques the complexity of modern graphics APIs rooted in legacy hardware abstractions and proposes a clean-slate design using 64-bit GPU pointers and CUDA-like memory management.

0 favorites 0 likes
#api-design

I put GPT 5.6, Opus 5 and minimax-M3 into the same simulated world to run restaurants. They all fail in the same 3 ways.

Reddit r/AI_Agents ↗ · 2026-08-05

A developer describes running AI agents in a simulated restaurant world and finds that across different models and harnesses, the same three API-related mistakes dominate: guessing nonexistent endpoints, exceeding budgets, and acting on stale IDs. Shows persistent failure patterns despite fixing the system.

0 favorites 0 likes
#api-design

Why I forked rand

Lobsters Hottest ↗ · 2026-07-31 Cached

The author explains why they forked Rust's rand crate into urandom, focusing on a smaller API surface, better discoverability, and a sealed Rng trait to simplify custom randomness use.

0 favorites 0 likes
#api-design

What it means for an API to be RESTful

Hacker News Top ↗ · 2026-07-30 Cached

This article explains the true meaning of RESTful APIs, emphasizing the importance of HATEOAS and hypermedia as the engine of application state, and argues that most modern APIs only reach Level 2 of the Richardson Maturity Model.

0 favorites 0 likes
#api-design

@alvinsng: https://x.com/alvinsng/status/2077114275412512868

X AI KOLs Following ↗ · 2026-07-14 Cached

Alvin Sng explains why their team moved away from using client SDKs for Stripe, WorkOS, and Slack, opting instead to call their REST APIs directly via a centralized wrapper. They argue that SDKs hide critical debugging details, are fragile in production, and encourage anti-patterns that are now more easily avoided with AI-assisted coding.

0 favorites 0 likes
#api-design

Designing APIs for Agents

Hacker News Top ↗ · 2026-07-13 Cached

The article argues that designing APIs for AI agents requires different principles than for humans, emphasizing clarity, explicitness, and avoiding defaults, because agents can read entire docs and write extensive code.

0 favorites 0 likes
#api-design

We gave our SaaS an MCP server (~150 tools) — now Claude runs our project management. Lessons learned.

Reddit r/AI_Agents ↗ · 2026-07-04

The SaaS company TRCR built an MCP server exposing ~150 tools for AI agents, and shares six key lessons from dogfooding with Claude: agents expose API flaws, tool descriptions matter as product copy, self-contained context is crucial, OAuth 2.1 is worth the pain, combining agents with billing data is powerful, and dogfooding shifts the product roadmap.

0 favorites 0 likes
Next →
← Back to home

Submit Feedback