umgeher/cowboy
0
Fork 0
mirror of https://github.com/ninenines/cowboy.git synced 2025-07-14 20:30:23 +00:00
Code Issues Wiki Activity

Add a specs document for RFC6585

Browse source 
Only a few status codes. Comments in the previous commit apply.
This commit is contained in:
Loïc Hoguin 2014-11-23 23:32:04 +02:00
parent 38b9a78d92
commit 2a2279adda
2 changed files with 45 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
doc/src/specs/index.ezdoc
View file

@ -3,4 +3,5 @@
The implementation reference documents the behavior of Cowboy The implementation reference documents the behavior of Cowboy
with regards to various standards and specifications. with regards to various standards and specifications.
* ^"RFC6585 status codes^rfc6585
* ^"RFC7230 HTTP/1.1 server^rfc7230_server * ^"RFC7230 HTTP/1.1 server^rfc7230_server

44
doc/src/specs/rfc6585.ezdoc Normal file
View file

@ -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.