servant-0.19.1: A family of combinators for defining webservices APIs

Safe Haskell | Safe-Inferred
Language | Haskell2010

Servant.API.Capture

Synopsis

- type Capture = Capture' '[]
- data Capture' (mods :: [*]) (sym :: Symbol) (a :: *)
- data CaptureAll (sym :: Symbol) (a :: *)

# Documentation

type Capture = Capture' '[] Source #

Capture a value from the request path under a certain type `a`.

Example:

    >>> -- GET /books/:isbn
    >>> type MyApi = "books" :> Capture "isbn" Text :> Get '[JSON] Book

data Capture' (mods :: [*]) (sym :: Symbol) (a :: *) Source #

`Capture` which can be modified. For example with `Description`.

#### Instances

Instances details

(ToHttpApiData v, HasLink sub) => HasLink (Capture' mods sym v :> sub :: Type) Source # |
Instance details Defined in Servant.Links Associated Types type MkLink (Capture' mods sym v :> sub) a Source # Methods toLink :: (Link -> a) -> Proxy (Capture' mods sym v :> sub) -> Link -> MkLink (Capture' mods sym v :> sub) a Source #
type MkLink (Capture' mods sym v :> sub :: Type) a Source # |
Instance details Defined in Servant.Links type MkLink (Capture' mods sym v :> sub :: Type) a = v -> MkLink sub a

data CaptureAll (sym :: Symbol) (a :: *) Source #

Capture all remaining values from the request path under a certain type `a`.

Example:

    >>> -- GET /src/*
    >>> type MyAPI = "src" :> CaptureAll "segments" Text :> Get '[JSON] SourceFile

#### Instances

Instances details

(ToHttpApiData v, HasLink sub) => HasLink (CaptureAll sym v :> sub :: Type) Source # |
Instance details Defined in Servant.Links Associated Types type MkLink (CaptureAll sym v :> sub) a Source # Methods toLink :: (Link -> a) -> Proxy (CaptureAll sym v :> sub) -> Link -> MkLink (CaptureAll sym v :> sub) a Source #
type MkLink (CaptureAll sym v :> sub :: Type) a Source # |
Instance details Defined in Servant.Links type MkLink (CaptureAll sym v :> sub :: Type) a = [v] -> MkLink sub a