API design

Created by CodeCraft LLC

Design and review HTTP APIs consumed by apps, partners, and agents

Product and technology names are trademarks of their respective owners, used only to identify what this skill covers. CodeCraft LLC is not affiliated with or endorsed by them.

by Jace (@jamick)v1.2.0 · updated 2026-10-16Report copyright infringement

Description

Design and review HTTP APIs consumed by apps, partners, and agents — resource modeling and URLs, method semantics, status codes, RFC 9457 Problem Details errors, cursor pagination, allow-listed filtering and sorting, idempotency keys for POST, optimistic concurrency with ETags, versioning and deprecation, consistent JSON conventions (casing, ISO 8601 UTC dates, money in minor units with currency), authentication, rate-limit headers, OpenAPI contracts, webhooks you send (signing, retries, event IDs), and when to use Next.js route handlers vs Server Actions. Use whenever the user designs or reviews a REST/JSON API, public or partner endpoints, webhooks for others, mobile-app backends, or an OpenAPI spec.

#backend#api#design

Included with all-access

$9.00 value as a single download

AiSkillz is in preview: browse the catalogue now - skill downloads and subscriptions open soon.

All skills are included with the all-access subscription

Changelog

v1.2.0Oct 16, 2026Latest

Added

references/rest-patterns.md: worked REST examples (envelopes, cursor pagination, idempotency-key implementation, rate-limit headers) - merged from the former api-rest-design skill.

v1.1.0Oct 3, 2026

Changed

Checked against the official documentation (October 2026).
Added OpenAPI 3.2: streaming media types (SSE), the QUERY method and additionalOperations, hierarchical tags, OAuth device flow - backward compatible with 3.1.

v1.0.1Oct 3, 2026

Changed

Added a trademark notice to the README.

v1.0.0Oct 2, 2026

Added

First release.