API Explorer Facelift

[Leigh Dodds]

Hi,

This morning we rolled out a new release of the API explorer. This
rolls in a number of outstanding bug fixes and a few small new
features. Hopefully this improves playing around with the various
Kasabi APIs.

Brief summary of the fixes:

* New page template with tidier layout
* Added additional links in the page header to relevant documentation
for the API, dataset, etc.
* Integrated tool tips for form fields to help guide users
* API results are now displayed in-line in the page, with
pretty-printing for JSON results(*)
* Added missing output format select for facet & reconciliation queries
* Fix Javascript and display issues with IE
* Fixed foaf prefix in SPARQL editor
* Fix problem pasting SPARQL queries in Firefox

*Note: the in-line display of results isn't supported in IE because of
its limited support for CORS. If you've modified your security
settings to allow (or prompt for permission) for cross-site requests
then you'll see results in-line. Otherwise they'll be displayed in the
browser as before. We may switch to JSON-P in future to avoid that
issue.

If you have any problems then please report then via zendesk [1]

Cheers,

L.

[1]. http://kasabi.zendesk.com

--
Leigh Dodds
CTO, Kasabi
Mobile: 07850 928381
http://kasabi.com
43 Temple Row
Birmingham
B2 5LS

[Leigh Dodds]

Hi,

On 23 January 2012 10:01, Leigh Dodds <l...@kasabi.com> wrote:
> Hi,
>
> This morning we rolled out a new release of the API explorer. This
> rolls in a number of outstanding bug fixes and a few small new
> features. Hopefully this improves playing around with the various
> Kasabi APIs.
>
> Brief summary of the fixes:
>

> ...

As part of some additional improvements this week, the API explorer
also now supports SPARQL Stored Procedure APIs. So if you've created a
custom API for an endpoint, then there will automatically be a simple
test form to allow users to play with it.

For example I created an API to find NHS organizations based on a
postcode. You can see the reference docs for it here:

http://kasabi.com/dataset/nhs-organization/apis/35v

The API explorer is here:

http://labs.kasabi.com/explorer/stored-procedure/dataset/nhs-organization/apis/35v

(You'll need your API key if you want to try it out)

The list of fields, their tool tips and the available output formats
are automatically generated based on the configuration of your API. So
as an API author, its useful to give parameters friendly names and
include comments to help guide people to using them.

We also gave the default linked data pages a facelift too [1].

Let us know if you have any feedback.

Cheers,

L.

[1]. http://data.kasabi.com/dataset/nhs-organization/general-practices/A81001