design

Documentation

Index

• Variables
• func PaginationQueryParams(page, pageSize int) (int32, int32)

Variables

var APIKeyAuth = APIKeySecurity("api_key", func() {
	Description("Secures endpoint by requiring an API key.")
})

APIKeyAuth defines a security scheme that uses API keys.

var AppVersion = Type("version", func() {
	Description("Application version information")
	Attribute("version", String, "Application version", func() {
		Example("1.0")
	})
	Attribute("build_time", String, "Application build time", func() {
		Example("")
	})
})

var BadRequest = Type("bad-request", func() {
	Description("bad-request indicates the values provided are invalid")
	Attribute("name", String, "Name of error", func() { Example("bad request") })
	Attribute("message", String, "Error message", func() {
		Example("bad request")
	})
	Attribute("detail", String, "Error details", func() {
		Example("Failed to validate information. Cannot continue.")
	})
	Required("message", "detail", "name")
})

var Forbidden = Type("forbidden", func() {
	Description("forbidden indicates access to a resource was denied")
	Attribute("name", String, "Name of error", func() { Example("forbidden") })
	Attribute("message", String, "Error message", func() {
		Example("bad request")
	})
	Attribute("detail", String, "Error details", func() {
		Example("Failed to determine machine information. Cannot continue.")
	})
	Required("message", "detail", "name")
})

var NotFound = Type("not-found", func() {
	Description("not-found indicates the resource matching the id does not exist.")
	Attribute("id", String, "ID of device", func() {
		Example("resource_1234567")
	})
	Attribute("name", String, "Name of error", func() { Example("not found") })
	Attribute("message", String, "Error message", func() {
		Example("bad request")
	})
	Attribute("detail", String, "Error details", func() {
		Example("Resource not found")
	})
	Required("message", "detail", "name")

})

var Origins = []string{
	"/127.0.0.1:\\d+/",
	"/localhost:\\d+/",
	"/192.168.(\\d+).(\\d+):\\d+/",
}

var PaginationMetadata = Type("PaginationMetadata", func() {
	Attribute("total", Int32, func() { Example(25) })
	Attribute("current_page", Int32, func() { Example(1) })
	Attribute("first_page", Int32, func() { Example(1) })
	Attribute("last_page", Int32, func() { Example(10) })
	Attribute("page_size", Int32, func() { Example(20) })
	Required("total", "page_size", "first_page", "current_page", "last_page")
})

var ServerError = Type("server-error", func() {
	Description("server-error indicates the server encountered an error.")
	Attribute("name", String, "Name of error", func() { Example("internal server error") })
	Attribute("message", String, "Error message", func() {
		Example("bad request")
	})
	Attribute("detail", String, "Error details", func() {
		Example("Failed to determine machine information. Cannot continue.")
	})
	Required("message", "detail", "name")
})

var TeamIn = Type("Team", func() {
	Description("Team object")
	Attribute("name", String, "Name", func() { Example("Dream Team") })
	Required("name")
})

var TeamResult = ResultType("application/vnd.tawny.team", func() {
	TypeName("Team")
	Description("A single team")
	Attribute("uuid", String, "Team ID", func() {
		Pattern(teamRx)
		Example("team_1234567")
	})
	Attribute("name", String, "Name", func() { Example("Dream Team") })
	Attribute("personal_team", Boolean, "personal_team", func() { Example(false) })
	createdAndUpdateAtResult()
	Required("uuid", "name", "personal_team")

	View(viewDefault, func() {
		Attribute("uuid")
		Attribute("name")
		Attribute("personal_team")
	})
})

var Unauthorized = Type("unauthorized", func() {
	Description("unauthorized indicates authentication failed")
	Attribute("message", String, "Message of the error", func() {
		Example("unauthorized")
	})
	Required("message")
})

var UserIn = Type("User", func() {
	Description("User object")
	Attribute("name", String, "Name of the user", func() { Example("Daniel") })
	Attribute("password", String, "ID of the user", func() { Example("fakePassword") })
	Attribute("email", String, "Email of the user", func() { Example("email@example.com") })
	Required("name", "password", "email")
})

var UserResult = ResultType("application/vnd.tawny.user", func() {
	TypeName("UserResult")
	Description("A single user")

	Attribute("user_uuid", String, "User ID", func() { Example("user_1234567") })
	Attribute("name", String, "name", func() { Example("Daniel") })
	Attribute("email", String, "Email", func() { Example("me@gmail.com") })
	Attribute("role", String, "Role", func() { Example("admin") })
	createdAndUpdateAtResult()
	Required("name", "email", "role")

	View(viewDefault, func() {
		Attribute("user_uuid")
		Attribute("name")
		Attribute("email")
		Attribute("role")
		Attribute("created_at")
		Attribute("updated_at")
	})
})

var UsersResult = ResultType("application/vnd.tawny.users", func() {
	TypeName("Users")
	Attributes(func() {
		Attribute("users", CollectionOf(UserResult))
		Attribute("metadata", PaginationMetadata)
		Required("users", "metadata")
	})
})

Functions

func PaginationQueryParams

func PaginationQueryParams(page, pageSize int) (int32, int32)

PaginationQueryParams returns the current_page and page_size values