Una Hakika

Summary of Changes

• Sightings query added

Input Parameters

The high-level schema for the WikiRumours API is as follows:

http://api.wikirumours.org/version/key/query-type/output/encoded-filters

Filters are key/value pairs which correspond to output parameters. So for instance, to retrieve all sightings of newly added Kenyan rumours, the filter segment would properly read country_id%3DKE%7Cstatus%3DNU.

Output Parameters

For illustrative purposes, output has been displayed below as XML.

[wikirumours]
  [version]VARCHAR(6)[/status]
  [status]TEXT[/status]
  [page]TINYINT(3)[/page]
  [number_of_results]INT[/number_of_results]
  [number_of_results_on_this_page]INT[/number_of_results_on_this_page]
  [warnings]
    [warning_code]INT(4)[/warning_code]
    [human_readable_warning]VARCHAR(255)[/human_readable_warning]
  [/warnings]
  [errors]
    [error_code]INT(4)[/error_code]
    [human_readable_error]VARCHAR(255)[/human_readable_error]
  [/errors]
  [number_of_queries_today]INT[/number_of_queries_today]
  [data]

    {data structure is dependent on requested query type}

  [/data]
[/wikirumours]

Rumour data is presented with this structure:

    [datapoint]
        [rumour_id]VARCHAR(6)[/rumour_id]
        [rumour]TEXT[/rumour]
        [country_abbreviation]CHAR(2)[/country_abbreviation]
        [country]VARCHAR(255)[/country]
        [region]VARCHAR(255)[/region]
        [latitude]DECIMAL(11,7)[/latitude]
        [longitude]DECIMAL(11,7)[/longitude]
        [occurred_on]DATETIME[/occurred_on]
        [status_abbreviation]CHAR(2)[/status_abbreviation]
        [status]VARCHAR(255)[/status]
        [findings]TEXT[/findings]
        [number_of_sightings]INT[/number_of_sightings]
    [/datapoint]

Sighting data is presented with this structure:

    [datapoint]
        [sighting_id]VARCHAR(6)[/sighting_id]
        [heard_on]DATETIME[/heard_on]
        [country_abbreviation]CHAR(2)[/country_abbreviation]
        [country]VARCHAR(255)[/country]
        [region]VARCHAR(255)[/region]
        [latitude]DECIMAL(11,7)[/latitude]
        [longitude]DECIMAL(11,7)[/longitude]
        [rumour]TEXT[/rumour]
        [occurred_on]DATETIME[/occurred_on]
        [status_abbreviation]CHAR(2)[/status_abbreviation]
        [status]VARCHAR(255)[/status]
        [findings]TEXT[/findings]
    [/datapoint]

Error Handling

Incorrectly configured input parameters will result in an error being returned with the data. If the proper output format parameter cannot be determined, the default output for error messages is XML.