This is an extremely simple API service for use with the ZX Spectrum Next. If offers ZXDB search and download functionality.
This service is intentionally non-SSL to allow for the ZX Spectrum Next to process the requests.
All requests are
If processing on a Spectrum Next, you will need to pass the HTTP response headers, you can either wait for a
blank line (as per HTTP specification to represent the start of the body) or
curl and count the
headers you need to skip. Current this code is hosted on Heroku so the headers shouldn't change in the foreseeable
future - but this is not a given.
Searches for an entity based on a query using the zxinfo search engine. Returns a maximum of 10 of encoded results.
spaces: if the search term includes spaces, to reduce encoding requirements, spaces are represented
* character. So "target renegade" is
^25483^Target: Renegade^Target-Renegade.tzx^116696^2^1988^ ^25485^Target: Renegade^Target-Renegade128.tap^112085^1^1988^ ^25486^Target: Renegade^Target-Renegade48.tap^107007^1^1988^ ^25487^Target: Renegade^Target-Renegade(ErbeSoftwareS.A.).tzx^112472^2^1988^ ^25489^Target: Renegade^Target-Renegade(TheHitSquad).tzx^116696^1^1990^ ^25459^Renegade^Renegade.tzx^67665^2^1987^ ^25461^Renegade^Renegade128.tap^71429^1^1987^ ^25462^Renegade^Renegade48.tap^48977^1^1987^ ^25463^Renegade^Renegade(ErbeSoftwareS.A.).tzx^59640^2^1987^ ^25465^Renegade^Renegade(TheHitSquad).tzx^62903^2^1989^
The fields are separated by the
^ character and rows are terminated by
The fields are:
id is required to download a file.
In the case where the number of file options (field 5) to request file 2, append
/2 to the
By default all types of records are returned. You can narrow the results with a query string
n is short for:
g- games only
a- apps and utilities
d- demos including music
If a category short code isn't recognised, the filtering is disabled.
Returns a binary stream with
content-length header set for the given file
file format will be the type associated with the particular ID.
Open source and built by Remy Sharp