```fun add(value1: Int, value2: Int): HttpHandler ...

# http4k

[dave]

fun add(value1: Int, value2: Int): HttpHandler = {
        Response(OK).with(
            Body.string(TEXT_PLAIN).toLens() of (value1 + value2).toString()
        )}

    val contract = contract(OpenApi(ApiInfo("my great api", "v1.0"), Argo),
        "/add" / <http://Path.int|Path.int>().of("value1") / Path.fixed("hello") / <http://Path.int|Path.int>().of("value2") meta {
            summary = "add"
            description = "Adds 2 numbers together"
            returning("The result" to OK)
        } bindContract GET
            to { a, _, c -> add(a, c) }
    )

    contract.asServer(Jetty(8000)).start()

[elifarley]

In this example, how can I see the generated API documentation ?

[dave]

The docs default to the root

[elifarley]

so it should be at http://localhost:8000/ ?

[elifarley]

or http://localhost:8000/add ?

[elifarley]

I've tested both and they don't work. I mean, I've tested on my own setup, which is a bit different:

[elifarley]

val productsRoute: RouteBinder<(String, String) -> HttpHandler> =
"/catalogs" / Path.string().of("catalog-name", "Catalog name ('Client-Realm-Id' in headers)") /
Path.fixed("products") meta {
summary = "Get products from a catalog given a catalog name"
} bindContract GET

val sgzrHandler: RoutingHttpHandler = routes(
"/sgzr/api/v1" bind contract(OpenApi(ApiInfo("Stargazer-O API", "v1.0"), Argo), "Manages product sales", security,
echoRoute to ::echo,
productsRoute to { a, _ -> getProducts(a) }
)
)

[dave]

it should be at the root of the contract, which in your case is /sgzr/api/v1

[elifarley]

Ok, I'll focus my tests on the root of the contract

[elifarley]

RESPONSE 404 to GET: /sgzr/api/v1/
However:
RESPONSE 200 to GET: /sgzr/api/v1/catalogs/x/products

[dave]

Hnm - can you try overriding the path of the description route?

[dave]

(in the contract method)

[dave]

@elifarley got it - the problem is that you've passed in a description where the path to the description route should be.

[elifarley]

hmmm

[dave]

val productsRoute: RouteBinder<(String, String) -> HttpHandler> =
        "/catalogs" / Path.string().of("catalog-name", "Catalog name ('Client-Realm-Id' in  headers)") /
            Path.fixed("products") meta {
            summary = "Get products from a catalog given a catalog name"
        } bindContract GET

    val sgzrHandler: RoutingHttpHandler = routes(
        "/sgzr/api/v1" bind contract(OpenApi(ApiInfo("Stargazer-O API", "v1.0"), Argo), "", NoSecurity,
            productsRoute to { a, _ -> { Response(OK) } }
        )
    )

    sgzrHandler.asServer(Jetty(8000)).start()

[elifarley]

I see. Should I create a PR to change the argument name from description to descriptionPath ?

[elifarley]

Or it's better not to change it?

[dave]

weird - which version are you on? that argument should already be called descriptionPath. Here's the source:

fun contract(renderer: ContractRenderer = NoRenderer, descriptionPath: String = "", security: Security = NoSecurity, vararg serverRoutes: ContractRoute) =
    ContractRoutingHttpHandler(renderer, security, descriptionPath, "", serverRoutes.map { it })

[elifarley]

Duh! My bad!!! It's already properly named descriptionPath !!!

[elifarley]

thanks again 🙂

[elifarley]

I guess I just did it too hastily

[dave]

no problem. This is the problem with Strings - they're just not very descriptive! We don't have a type for "path segment", so it ended up being a string 🙂

[elifarley]

I see...