API Docs

YourBeach è il gestionale spiaggia e ristorazione per le strutture balneari.

Tramite le API è possibile gestire le prenotazioni della propria spiaggia, le anagrafiche clienti e i servizi extra scambiando i dati con altri applicativi.

Questa guida descrive come utilizzare le RestAPI di YourBeach e gestirne le risorse.

Autenticazione

Per accedere ai dati del gestionale è necessario autenticarsi.

Prima di effettuare una qualsiasi richiesta alle API bisogna richiedere un token alla risorsa oath/access_token. Il token ottenuto deve essere usato nelle successive richieste come parametro get “access_token”.

La chiamata per richiedere il token è la seguente:

GET https://www.anm22.it/app/world/api/v1/oauth/access_token?client_id=app-id&client_secret=secret-key&grant_type=client_credentials


Il client_id e il client_secret devono essere richiesti allo staff YourBeach.

Struttura

La struttura delle API ANM22 YourBeach è di tipo Rest e i metodi HTTP hanno il seguente significato:

GET: lettura
POST: aggiunta
PUT: modifica
DELETE: cancellazione

Al seguente link una guida sulle REST API https://www.restapitutorial.com/.

Unità di misura

Date: tutte le date sono espresse come Unix timestamp.
Timezone: sono espressi secondo timezone PHP o sigle standard (esempio “CET”).