Maiden-Api-Access

About

This is a very, very small system to help you with the common task of accessing an HTTP API.

How To

There's only two functions you'll really need directly from this, request-as and json-v.

(maiden-api-access:request-as
  :json "https://maps.googleapis.com/maps/api/geocode/json"
  :get `(("sensor" "false") ("address" "Hong Kong"))
(values (list (json-v * "geometry" "location" "lat")
              (json-v * "geometry" "location" "lng"))
        (json-v * "address_components" 0 "long_name"))

And that's already pretty much all she wrote.

Copyright

maiden-api-access is licensed under the Artistic license. © Nicolas Hafner <shinmera@tymoon.eu> . This library can be obtained on https://github.com/Shinmera/maiden.

Package Index

MAIDEN-API-ACCESS (ORG.SHIRAKUMO.MAIDEN.MODULES.API-ACCESS)

function (

`JSON-V`

JSON &REST PATH)

Easily access a value in a JSON object as parsed by JSOWN.

See PARSE-TO

function (

`PARSE-TO`

TYPE INPUT)

Attempt to parse the input string to a certain type of data.

TYPE can be one of
- :STRING     Just return the input again.
- :JSON       Parse the input into a JSON object.
- :HTML :XML  Parse the input into a DOM.
- :SEXP       Parse the input as a SEXP.

See JSOWN:PARSE
See PLUMP:PARSE
See CL:READ-FROM-STRING

function (

`REQUEST`

URL &KEY GET POST (METHOD :GET) (EXTERNAL-FORMAT :UTF8) OTHER-ARGS)

Perform an HTTP request.

The URL is preserved as-is, and no encoding is performed on it.
You will have to make sure each URL character is already encoded
as necessary. GET and POST parameters are however encoded as
expected for a request.

See REQUEST-AS

function (

`REQUEST-AS`

TYPE URL &REST ARGS &KEY GET POST EXTERNAL-FORMAT OTHER-ARGS)

Perform an HTTP request and parse the data into the requested format.

See REQUEST
See PARSE-TO