Romhack Plaza Public API - How to use it and questions

Auth
Everyone
If you'd like to link to Romhack Plaza on your various platforms, we've set up a public API.

This allows you to retrieve information about an entry, an author, a user, etc., as well as download links. It can also be used to obtain entries in relation to the CRC32 / SHA-1 of the ROM, useful for certain platforms such as Recalbox.

The URL is: https://romhackplaza.org/public_api/rhpz/v1/{endpoint}
To authenticate yourself, you'll need your e-mail address and the API key. You'll need to include the following string in your request header: {account e-mail}:{API key} (basic authentication).

You'll find detailed documentation of all endpoints in this forum. Threads are available below to ask questions about these endpoints.

On each request, you'll also have the following four fields:

NameTypeDescription
codestringThe code begin by 'rest_', may be ok, ko, not_found, forbidden, ...
messagestringUsed if there is an error with the request
statusstringIf the request is from the server, OK or KO
requested_idstringThe first field from the request, it's frequent this is an ID like an Entry ID

If you have any ideas for new endpoints, please let me know so that I can add them if possible.
 
You can now generate an API Key by yourself if you are a verified member on the website. (For standard members, please contact me).
To do that, you can follow that link : https://romhackplaza.org/wp-admin/admin.php?page=romhackplaza-enable-api (Or you can find it in Edit Profile -> RomhackPlaza -> User - Enable API)
Here, you can enable the API for your account or not.

After you enable the API, you can create an API Key in "Edit Profile" via Applications Passwords.
1747928455250.webp
You can give a name to your key and generate it. To use the key, you need to remove spaces when you'll use it !
 


Write your reply...
Back
Top