Web API implementation Guide - kanna

Web API implementation Guide

Software design 101 practice specific to Web API

Design practice for web API

API design guide | Google Cloud

example

googleapis/google/cloud at master · googleapis/googleapis

Web API 設計のベストプラクティス - Azure Architecture Center | Microsoft Learn

The Web API Checklist – 43 Things To Think About When Designing, Testing, and Releasing your API | Mathieu Fenniak

API Designs - ebiken

JSON:API — Latest Specification (v1.0)

Practical API Design at Netflix, Part 1: Using Protobuf FieldMask | by Netflix Technology Blog | Netflix TechBlog

shieldfy/API-Security-Checklist: Checklist of the most important security countermeasures when designing, testing, and releasing your API

Web API設計ガイドライン | Future Enterprise Arch Guidelines

HTTP検索条件、GETにするか？POSTにするか？ | フューチャー技術ブログ

Public API documents

Web API設計ガイドラインを公開しました | フューチャー技術ブログ

https://github.com/mcollina/autocannon

schema first

code first もありえる

https://zenn.dev/waddy/books/graphql-nestjs-nextjs-bootcamp/viewer/nestjs#コードファーストとスキーマファースト

schema first であれば、サーバーサイドの実装をまたずにクライアント側の実装ができる？

規模が大きいとこっちのほうがいいのかな？

構築時に意識したいこと

endpoint 定義

環境

Web FWで env 設定できるよ

変数があるかは起動時にチェックしようね

graceful shutdown

credential managemant

timeout

文字コード

Request ID or idempotency key in Web API

Pagination of API

メルカリShops APIの紹介 | メルカリエンジニアリング

rest - HATEOAS: concise description - Stack Overflow

Errors

AIP-193: Errors

WebAPIでエラーをどう表現すべき？15のサービスを調査してみた - Qiita

RFC 9457: Problem Details for HTTP APIs

Resource ID

Designing APIs for humans: Object IDs - DEV Community

リクエストに署名

Signing Requests | Cash App Pay Partner API

api key の権限を階層的にする

API keys | Stripe Documentation