Intro
Data for the Afghanistan Election Data site is stored in two separate github repositories:
- af-election-api contains the global configuration file with the list of elections being displayed in the site, a configuration file for each of the elections and, the election's trends or stories.
- af-election-data contains the results and the admin areas for each election.
The CLI tool processes the data and creates a static api which consists of a set of pre-processed JSON files. These files are stored in a S3 bucket with a predictable URL structure that resemble REST endpoints.
This documentation site lays out how to configure the elections and what the api response is expected to be.
Error response
Errors on Amazon S3 are structured as REST Error responses.
For example, when requesting an object that does not exists, S3 will return a 404
with:
<Error>
<Code>NoSuchKey</Code>
<Message>The specified key does not exist.</Message>
<Key>elections/does-not-extist</Key>
<RequestId>0123456789ABC</RequestId>
<HostId>0123456789ABC</HostId>
</Error>