Assicurati di avere una chiave API e di aver ottenuto un token utilizzando il tipo di concessione OAuth 2.0 delle credenziali client. (Per ulteriori informazioni, consulta la Guida introduttiva ).
Recupera l'elenco degli edifici utilizzando l'endpoint v1/public/buildings .

per esempio

GET <https://api.onkadence.co/v1/public/buildings

>

{ "@context": "/v1/contexts/Building", "@id": "/v1/public/buildings", "@type": "hydra:Collection", "hydra:totalItems": 1, "hydra:member": [ { "@id": "/v1/public/buildings/01EMPPAER4FWYN1MSBW0NAZSBK", "@type": "Building", "id": "01EMPPAER4FWYN1MSBW0NAZSBK", "name": "Bell Yard Coffee - Bell Yard", "timeZone": "Europe/London", "latitude": "51.51459200", "longitude": "-0.11192900", "addressLine1": "1 Quality Court", "addressLine2": "Holborn", "city": "London", "county": "Greater London", "countryCode": "GB", "createdAt": "2023-06-29T08:40:31+00:00", "modifiedAt": "2023-07-07T10:27:00+00:00", "countryName": "United Kingdom" } ], "hydra:view": { "@id": "/v1/public/buildings?countryCode=GB&city=London&name=Bell%20Yard", "@type": "hydra:PartialCollectionView" }, "hydra:search": { "@type": "hydra:IriTemplate", "hydra:template": "/v1/public/buildings{?}", "hydra:variableRepresentation": "BasicRepresentation", "hydra:mapping": [] } }

Per ogni edificio, recupera i relativi piani utilizzando l'endpoint v1/public/floors . Questa API supporta il filtraggio tramite il parametro di query buildingId.

per esempio

GET <https://api.onkadence.co/v1/public/floors?buildingId=01EMPPAER4FWYN1MSBW0NAZSBK

>

{ "@context": "/v1/contexts/Floor", "@id": "/v1/public/floors", "@type": "hydra:Collection", "hydra:totalItems": 2, "hydra:member": [ { "@id": "/v1/public/floors/01F01JHXDZCKNP4J9N9PA878Q1", "@type": "Floor", "id": "01F01JHXDZCKNP4J9N9PA878Q1", "name": "Floor 1", "floorplanUrl": "<https://static.onkadence.co/a/floorplan.svg>" }, { "@id": "/v1/public/floors/01FXSN478SSJAEEWJ26F9MHK4W", "@type": "Floor", "id": "01FXSN478SSJAEEWJ26F9MHK4W", "name": "Floor 2", "floorplanUrl": "<https://static.onkadence.co/another/floorplan.svg>" } ], "hydra:view": { "@id": "/v1/public/floors?buildingId=01EMPPAER4FWYN1MSBW0NAZSBK", "@type": "hydra:PartialCollectionView" } }

Caricare l'SVG da floorplanUrl . Ogni spazio sul piano è rappresentato come un elemento SVG con un ID nel formato:

space::{space_type}::{spaceId}
Recupera le prenotazioni per un piano specifico utilizzando l'endpoint v1/public/bookings . Puoi filtrare per ID piano e intervallo di date per ottenere le prenotazioni per un determinato giorno o periodo.
per esempio

GET <https://api.onkadence.co/v1/public/bookings?floorId=01F01JHXDZCKNP4J9N9PA878Q1&order[startDateTime]=asc&startDateTime[local_after]=2023-01-01T00:00:00Z&startDateTime[local_before]=2023-01-01T23:59:59Z

>

{ "hydra:member": [ { ... "id": "01GTBV1CT3BM8A42SEJ2J5F4EG", "startDate": "2023-01-01T09:00:00+00:00", "endDate": "2023-01-01T17:00:00+00:00", "status": "booked", "type": "desk", "building": "/v1/public/buildings/01EMPPAER4FWYN1MSBW0NAZSBK" } ], "hydra:totalItems": 1 }
Mappa lo spaceId di ogni risultato di prenotazione all'elemento SVG corrispondente utilizzando il formato ID indicato sopra. Puoi quindi applicare uno stile all'elemento SVG in base allo stato della prenotazione. Ad esempio:

riempimento: #60D27B (verde) per disponibile
compila: #FF9B53 (arancione) per prenotato

Per mantenere aggiornata la planimetria, interrogare periodicamente l'endpoint delle prenotazioni (ad esempio ogni 5 minuti) per riflettere le modifiche di disponibilità in tempo reale.

Per un esempio funzionante e il codice sorgente completo, visita il nostro repository GitHub per l'app di esempio.

Panoramica