Switch on the test API
The course is free and open to everyone. The test server the examples run on
(/api/v1, Swagger at /api/docs, the sandboxes), on the other hand, stays off when nobody
uses it: it is a service that writes to disk and accepts queries, and leaving it open day and
night to anyone makes no sense.
Checking the API status…
While it is on you can run every example in the course. After an hour without calls it switches itself off, and this page will tell you.
How it works
Section titled “How it works”- With the API off every call answers 503 with a message pointing to this page:
the chapters can still be read, but the «Try it» widgets and the
curlexamples do not answer. - Once on, it stays active as long as it is used, and switches itself off after an hour without calls. There is no need to switch it off by hand.
- Whoever has the password can switch it on again whenever they like. Wrong attempts are limited (five every quarter of an hour per address), so that nobody can guess it by trial and error.
Checking the status from the command line
Section titled “Checking the status from the command line”The status is public and can be read without a password:
curl -s https://corso-api-json.giuseppebosi.com/api/v1/interruttore{ "attiva": false, "spegnimento_tra_s": 0, "minuti_di_inattivita": 60, "configurata": true }(attiva = on, spegnimento_tra_s = seconds until it switches off, minuti_di_inattivita =
idle minutes before switching off, configurata = configured.)
And this is what the API answers when it is off:
{ "error": { "code": "api_spenta", "message": "API di prova spenta: attivala da https://corso-api-json.giuseppebosi.com/api-attiva/", "details": { "attiva_da": "https://corso-api-json.giuseppebosi.com/api-attiva/", "stato": "/api/v1/interruttore" } }}