CSV to API
Dynamically generate RESTful APIs from static CSVs. Provides JSON, XML, and HTML.
What Problem This Solves
The simplicity with which CSV files can be created has made them the default data format for bulk data. It is comparatively more difficult to create an API to share the same data atomically and transactionally.
How This Solves It
CSV to API acts as a filter, sitting between CSV and the browser, allowing users to interact with that CSV as if it was a native API. The column names (that is, the cells that comprise the first row in the file) function as the key names.
Note that this can be run on any server to create an API for any CSV file on any server. There is no need to install CSV to API for each unique CSV file or even each unique server—an organization can link to each and every one of their CSV files via CSV to API, or an individual could even use their own installation of CSV to API to access arbitrary remote CSV files as if they were APIs.
When Alternative PHP Cache (APC) is installed, parsed data is stored within APC, which accellerates its functionality substantially. While APC is not required, it is recommended highly.
- APC (optional)
index.phpto your web server.
- Load a CSV file via the URL
index.php, using the arguments below.
source: the URL to the source CSV
source_format: if the url does not end in
.csv, you should specify 'csv' here (to facilitate future functionality)
format: the requested return format, either
callback: if JSON, an optional JSONP callback
sort: field to sort by (optional)
sort_dir: direction to sort, either
- any field(s): may pass any fields as a key/value pair to filter by
header_row: whether the source CSV has a header row; if missing, it will automatically assign field names (
field_2, etc.); either
All examples use data from REXUS, the primary tool used by the Public Building Service to track and manage the government's real property assets and to store inventory data, building data, customer data, and lease information.
Get CSV as JSONP (default behavior)
Get results as XML
Get results as JSONP with a specified callback
Get results as HTML
Sort by a field
Filter by a field
GPLv3 or later.