Skip to content
~/sph.sh

api-design

13 posts

api-design
DynamoDB Pagination: Signed Cursors, Sorting, and the Count Problem

DynamoDB has no OFFSET, no arbitrary ORDER BY, and no cheap COUNT. Ship signed next/prev cursors, model sort orders as sort keys, and drop the total count.

dynamodb · aws · data-storage-orm +2

Bruno API Collections in Git: A Workflow Shift, Not Free Postman

Committing Bruno .bru files to the repo keeps the API contract in the same PR and history as the code. The only real tax is a deliberate secrets boundary.

testing · ci-cd · developer-experience +1

Mobile API Versioning with a BFF: Shipping When You Can't Roll Back the Client

A mobile binary can't be rolled back and old versions linger, so safety and speed move server-side: a BFF, consumer-driven contracts, and backward-compatible versioning.

mobile · api-design · testing +1

Hexagonal Architecture for a Presentation Service vs BFF

A presentation service is the thin backend behind a UI fragment. Ports-and-adapters keeps it from rotting into glue code by pointing dependencies inward.

architecture · nodejs · typescript +3

Handling Long-Running API Requests in Web and Mobile Apps

One default shape for long-running work across a browser SPA and a mobile app, with the cases where it should be overridden.

api-design · real-time · webhooks +4

Idempotency: A Beginner's Guide to Safe Retries in APIs

A practical introduction to idempotency for developers building APIs, payments, and message consumers, covering HTTP semantics, idempotency keys, and upserts.

idempotency · api-design · distributed-systems +4

Zapier MCP Permission Control: Scoping AI Agent API Access

How Zapier MCP gives AI agents action-level whitelisting, credential isolation, and human-in-the-loop approval, a managed alternative to custom scoped proxies.

mcp · security · ai-agents +4

MCP vs Direct API Access for AI Agents: When to Skip the MCP Layer

Why production teams replace broad MCP access with scoped API proxies. Atlassian, Google Workspace, and Notion via FastAPI proxy, CLI wrapper, and n8n.

mcp · api-design · python +4

API Versioning Strategies in Practice: From First Release to Sunset

A practical guide to API versioning: URL vs header approaches, breaking changes, Sunset-header deprecation, AWS API Gateway, GraphQL, and contract testing.

api-design · deployment · graphql +4

Contract Testing with Pact - Ensuring API Compatibility in Microservices

A practical guide to consumer-driven contract testing with Pact in TypeScript microservices, catching breaking API changes before deployment.

testing · microservices · api-design +3

Building an MCP Server in TypeScript: A Production Guide

Learn how MCP standardizes AI tool integration, with TypeScript examples for building servers, managing security, and optimizing performance in production.

mcp · ai-adoption-strategy · claude +3

Strapi vs Contentful vs Storyblok vs Kontent.ai: A Headless CMS Comparison

A practical comparison of headless CMS options (Strapi, Contentful, Kontent, Storyblok) with Cloudinary image management and framework integration.

typescript · nextjs · react-native +3

Zod + OpenAPI + AWS Lambda: Schema-First API Development with CDK

Keep a Lambda API and its OpenAPI contract in sync by generating the spec from Zod schemas and wiring that generation into CDK deployment.

api-gateway · aws-cdk · lambda +4