http-media

Processing HTTP Content-Type and Accept headers

Version on this page:	0.6.3
LTS Haskell 23.21:	0.8.1.1@rev:2
Stackage Nightly 2025-05-05:	0.8.1.1@rev:2
Latest on Hackage:	0.8.1.1@rev:2

See all snapshots http-media appears in

MIT licensed by Timothy Jones

Maintained by Timothy Jones

This version can be pinned in stack with:http-media-0.6.3@sha256:f563f486cf3d4b6af720fc1dcc3badd68a3e890e417dba310b3aaef18beeda94,3566

Module documentation for 0.6.3

Network
- Network.HTTP
  - Network.HTTP.Media

Depends on 4 packages(full list with versions):

base, bytestring, case-insensitive, containers

Used by 9 packages in lts-5.13(full list with versions):

airship, servant, servant-blaze, servant-client, servant-docs, servant-JuicyPixels, servant-swagger, servant-yaml, swagger2

This library is intended to be a comprehensive solution to parsing and selecting quality-indexed values in HTTP headers. It is capable of parsing both media types and language parameters from the Accept and Content header families, and can be extended to match against other accept headers as well. Selecting the appropriate header value is achieved by comparing a list of server options against the quality-indexed values supplied by the client.

In the following example, the Accept header is parsed and then matched against a list of server options to serve the appropriate media using mapAcceptMedia:

getHeader >>= maybe send406Error sendResourceWith . mapAcceptMedia
    [ ("text/html",        asHtml)
    , ("application/json", asJson)
    ]

Similarly, the Content-Type header can be used to produce a parser for request bodies based on the given content type with mapContentMedia:

getContentType >>= maybe send415Error readRequestBodyWith . mapContentMedia
    [ ("application/json", parseJson)
    , ("text/plain",       parseText)
    ]

The API is agnostic to your choice of server.