[B! rfc] takuma510のブックマーク

HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様

今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Probl em Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application

takuma510 2019/05/21

RFC
HTTP

リンク

RFC 7807: Problem Details for HTTP APIs

Internet Engineering Task Force (IETF) M. Nottingham Request for Comments: 7807 Akamai Category: Standards Track E. Wilde ISSN: 2070-1721 March 2016 Probl em Details for HTTP APIs Abstract This document defines a "probl em detail" as a way to carry machine- readable details of errors in a HTTP response to avoid the need to define new error response formats for HTTP APIs. Status of This Memo This is

takuma510 2019/05/21

RFC
api

リンク

HTTPステータスコードを適切に選ぶためのフローチャート : 難しく考えるのをやめよう | POSTD

HTTPステータスコードを返すというのはとても単純なことです。ページがレンダリングできた？よし、それなら 200 を返しましょう。ページが存在しない？それなら 404 です。他のページにユーザをリダイレクトしたい？ 302 、あるいは 301 かもしれません。 I like to imagine that HTTP status codes are like CB 10 codes. "Breaker breaker, this is White Chocolate Thunder. We've got a 200 OK here." — Aaron Patterson (@tenderlove) 2015, 10月 7 訳：HTTPのステータスコードのことは、市民ラジオの10コードみたいなものだと考えるのが好きです。「ブレーカー、ブレーカー、こちらホワイト・チョコレート・サンダー。200

takuma510 2016/03/06

HTTP
RFC

リンク

RFC 4287 The Atom Syndication Format 日本語訳 - futomi's CGI Cafe

このメモの状態本文書はインターネットコミュニティーのためのインターネット標準化過程プロトコルを定めるもであり、改善のための議論と提案を求めるものです。標準化の状況とこのプロトコルの位置づけに関しては、"Internet Official Protocol Standards" (STD 1) の最新版を参照してください。このメモの配布は自由です。著作権表示 Copyright (C) The Internet Society (2005). 要約この文書は、XMLベースのウェブコンテンツとメタデータ配信フォーマットであるAtomの仕様を定めるものです。目次 1. はじめに 1.1. 例 1.2. 名前空間とバージョン 1.3. 表記の決まり 2. Atom文書 3. 共通のAtomコンストラクト 3.1. Textコンストラクト 3.1.1. "type"属性 3.2. Perso