KeymanWeb Cloud Services API - version 2.0

API usage

Version 2.0 of the API is a RESTful web service available through HTTP and HTTPS that returns only UTF-8 JSON formatted data. URIs in the data will reflect the protocol that is used to query the web service.

Endpoints

The two endpoints below can be used interchangeably. api.keyman.com is the modern endpoint; future services will be available there.

• https://api.keyman.com/cloud/4.0
• https://r.keymanweb.com/api/4.0

Interfaces

Parameters

The parameters below can be provided as query parameters in the URL.

device : optional : Can currently be any of the following: "windows", "macosx", "iphone", "ipad", "androidphone", "androidtablet", "mobile", "desktop", "tablet", "any". The server will filter keyboards according to the device type. If absent, then "any" is used.

dateformat : optional : Can be "seconds" or "standard". If absent, then "standard" is used. Reflects the format of any date values returned.

languageidtype : optional : Can be "iso6393" or "bcp47". If absent, then "iso6393" is used. Reflects the type of any language identifiers returned.

version : optional : The version of Keyman Engine, e.g. "10.0". If absent, uses "9.0". The server will filter keyboards that are available for that version of Keyman Engine. (See KeymanWeb Versioning for details on valid version numbers.)

Returned JSON

The CloudServices object

The CloudServices object is the base object returned from any API call. Note that the members keyboards, languages, keyboard, and language are all mutually exclusive.

options : Object : An Options object corresponding to the user-selected query options

keyboards : optional : Array of Keyboard objects.

languages : optional : Array of Language objects.

keyboard : optional : Keyboard object.

language : optional : Language object.

The Options object

The Options object returns the original query parameters plus contextual information. Contains the following members:

context : string : The context of the call. Will be one of the following four values: 'keyboards', 'languages', 'keyboard', 'language'

dateFormat : string : Either 'seconds' or 'standard', corresponding to the requested date format if specified.

device : string : Target device. Will be 'all' if not specified.

keyboardid : string optional : id of the keyboard queried, if provided.

languageid : string optional : id of the language queried, if provided.

keyboardBaseUri : string : fully qualified base path of any keyboard filenames presented in the data.

fontBaseUri : string : fully qualified base path of any font filenames presented in the data.

Example Call

GET https://api.keyman.com/cloud/2.0/keyboards/european/fra

Returns:

{
  "options": {
    "context":"keyboard",
    "dateFormat":"standard",
    "device":"any",
    "keyboardBaseUri":"https:\/\/s.keyman.com\/kmw\/kbd\/",
    "fontBaseUri":"https:\/\/r.keymanweb.com\/20\/fonts\/",
    "keyboardid":"european",
    "languageid":"fra"
  },
  "keyboard":{
    "id":"european",
    "filename":"european.js",
    "lastModified":"2012-03-02T16:36:15+11:00",
    "maxVersion":299,
    "languages":[
      {
        "id":"fra",
        "name":"French",
        "example":{
          "keys":"`A bient^ot",
          "text":"\u00c0 bient\u00f4t",
          "note":"\"Goodbye\""
        }
      }
    ]
  }
}