From 2a2279adda1381d41a5a893cfc1e69483a26971b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Sun, 23 Nov 2014 23:32:04 +0200 Subject: Add a specs document for RFC6585 Only a few status codes. Comments in the previous commit apply. --- doc/src/specs/index.ezdoc | 1 + doc/src/specs/rfc6585.ezdoc | 44 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 45 insertions(+) create mode 100644 doc/src/specs/rfc6585.ezdoc (limited to 'doc') diff --git a/doc/src/specs/index.ezdoc b/doc/src/specs/index.ezdoc index b315cf5..847780b 100644 --- a/doc/src/specs/index.ezdoc +++ b/doc/src/specs/index.ezdoc @@ -3,4 +3,5 @@ The implementation reference documents the behavior of Cowboy with regards to various standards and specifications. +* ^"RFC6585 status codes^rfc6585 * ^"RFC7230 HTTP/1.1 server^rfc7230_server diff --git a/doc/src/specs/rfc6585.ezdoc b/doc/src/specs/rfc6585.ezdoc new file mode 100644 index 0000000..7b19aa0 --- /dev/null +++ b/doc/src/specs/rfc6585.ezdoc @@ -0,0 +1,44 @@ +::: RFC6585 + +This document lists status codes that Cowboy implements as +defined in the RFC6585 specifications. + +:: Status codes + +: 428 Precondition Required (RFC6585 3) + +The server requires the request to this resource to be conditional. + +The response should explain how to resubmit the request successfully. + +: 429 Too Many Requests (RFC6585 4, RFC6585 7.2) + +The user has sent too many requests in a given amount of time. + +The response should detail the rates allowed. + +The retry-after header can be used to indicate how long the +user has to wait before making a new request. + +When an attack is detected it is recommended to drop the +connection directly instead of sending this response. + +: 431 Request Header Fields Too Large (RFC6585 5, RFC6585 7.3) + +The request's header fields are too large. + +When rejecting a single header, the response should detail +which header was at fault. + +When an attack is detected it is recommended to drop the +connection directly instead of sending this response. + +: 511 Network Authentication Required (RFC6585 6) + +The user needs to authenticate into the network to gain access. + +This status code is meant to be used by proxies only, not by +origin servers. + +The response should contain a link to the resource allowing +the user to log in. -- cgit v1.2.3