REST API
参考:
REST APIとは? – API設計のポイント | イケてないコード
REST (API) が理解できないのでまとめてみる:株式会社サブスレッド
なぜポストREST APIが求められるのか? REST APIがカバーできない2つの要因とその対策 – Morning Girl
What is an API, REST, SOAP, XML, JSON, WSDL and Other Definitions | MarTech
HTTPメソッド
- POST
- GET
- PUT/PATCH
- DELETE
CRUD
- Create
- Read
- Update
- Delete
参考:
Railsの誤解:CRUDはRESTじゃない! – 杉風呂2.0 – A Lifelog –
RESTfulな設計とCRUDはちょっと相性悪いという話 – yojikのlog
エラーコード
- 200〜:正常なレスポンス
- 300〜:リダイレクト
- 400〜:リクエストエラー (ユーザー入力に起因するエラーなど)
- 500〜:サーバー内部のエラー
参考:
レスポンスデータの設計 – 5分で絶対に分かるAPI設計の考え方とポイント (6/6) – @IT
Resource Naming Conventions/Guideline
参考:
REST Resource Identifier (URI) Naming – REST API Tutorial
Are there any naming convention guidelines for REST APIs? – Stack Overflow
What is Needed to Design a REST API | Nuxeo Documentation
API design guidance | Microsoft Docs
51 Elliot: REST API Best Practices 4: Collections, Resources and Identifiers
RESTful API Designing guidelines — The best practices
Hypertext Style: Cool URIs don’t change. – W3C
How Do I Name Folders & Product Files Effectively? | Search Engine Journal
The Ultimate Guide for an SEO-Friendly URL Structure | Search Engine Journal
15 SEO Best Practices for Structuring URLs – Moz
公開されている Web API を探す
参考: