http:headers

Create a header map to use with the http client.

Parameters They work as pairs with:

name: string
value: string

Return value UserType<httpHeaders>

Author

@SuperFola

Example

(let headers (http:headers
    # pair 0
    "Accept-Encoding" "gzip, deflate"
    # pair 1
    "Content-Type" "application/json"))

http:client

Create a http client to query a server.

Parameters

host: string, you must not put the protocol http:// nor https://
port: number

Return value List if the request succeeded: [status, body], otherwise nil

Author

@SuperFola

Example

(let cli (http:client "localhost" 1234))

http:get

Get content from an online resource.

Parameters

client: UserType<httpClient>
route: string
headers: UserType<httpHeaders>, optional, always come last

Return value List if the request succeeded: [status, body], otherwise nil

Author

@SuperFola

Example

(let headers (http:headers:create
    "Accept-Encoding" "gzip, deflate"))
(let cli (http:client "localhost" 1234))
 
(mut output (http:get cli "/hi" headers))
(if (nil? output)
    (print "couldn't reach the server")
    (print (@ output 0)))  # print the status

http:post, http:put, http:patch, http:delete

Make a POST / PUT / PATCH / DELETE request with a String as the request's body.

Parameters

client: UserType<httpClient>
route: string
body: string (request body)
mimetype: string, optional (defaults to text/plain)
headers: UserType<httpHeaders>, optional, always come last

Return value List if the request succeeded: [status, body], otherwise nil

Author

@SuperFola

Example

(let cli (http:client "localhost" 1234))
 
(mut output (http:post cli "/hi" "{\"key\": 5}" "application/json" headers))
(if (nil? output)
    (print "couldn't reach the server")
    (print (@ output 0)))  # print the status