Add ErrUnauthorized error variable

For use in security middlewares.

Author: raphael

design/apidsl/security.go

@@ -11,7 +11,14 @@ import (
 //
 // The scheme refers to previous definitions of either OAuth2Security, BasicAuthSecurity,
 // APIKeySecurity or JWTSecurity.  It can be a string, corresponding to the first parameter of
-// those definitions, or a SecuritySchemeDefinition, returned by those same functions.
+// those definitions, or a SecuritySchemeDefinition, returned by those same functions. Examples:
+//
+//    Security(BasicAuth)
+//
+//    Security("oauth2", func() {
+//        Scope("api:read")  // Requires "api:read" oauth2 scope
+//    })
+//
 func Security(scheme interface{}, dsl ...func()) {
 	var def *design.SecurityDefinition
 	switch val := scheme.(type) {

error.go

@@ -33,6 +33,9 @@ var (
 	// ErrBadRequest is a generic bad request error.
 	ErrBadRequest = NewErrorClass("bad_request", 400)
 
+	// ErrUnauthorized is a generic unauthorized error.
+	ErrUnauthorized = NewErrorClass("unauthorized", 401)
+
 	// ErrInvalidRequest is the class of errors produced by the generated code when a request
 	// parameter or payload fails to validate.
 	ErrInvalidRequest = NewErrorClass("invalid_request", 400)