API pe' gestionali esterni

1. Che cosa permetteno 'e API

Cu 'na chiave API puoie, d'o software tujo, leggere e scrivere 'ncopp'ô calannario d'e strutture toie:

• leggere strutture e campe cu 'e identificative d'e lloro, necessarie pe' tutte l'ati chiammate;
• leggere 'e prenotazzioni 'e 'nu periodo, 'e 'na struttura o 'e 'nu campo sulo, pe' l'allineà a l'archivio tujo;
• crià prenotazzioni da fora (pe' essempio quanno 'nu cliente prenota d'o sito tujo), cu 'e stessi cuntrolle 'e sovrapposizzione e chiusura d'o pannello;
• modificà o scancellà 'na prenotazzione ca già ce sta (spustamento 'e orario o 'e campo, incasso, note, annullamento);
• leggere 'a dispunibilità 'e 'nu campo dint'a 'nu juorno: slot già occupate, orarie 'e apertura e chiusure straordinarie, accussì da prupone 'e slot libbere senza replicà 'e regole;
• leggere 'o listino 'e 'nu campo pe' ammustrà 'e priezze ô cliente finale.

Nun fanno parte 'e chesti API 'e richieste d' 'e organizzature pe' l'uso d' 'e campe dint'ê turnee (s'approvano dall'app), 'a criazione 'e strutture e campe, 'o sarvaggio 'e orarie, chiuse e listino: so' operaziune d' 'o pannello gestore.

2. Requisiti e attivazzione

1. Un account gestore campe VolleyFriends cu' ammeno 'na struttura e 'nu campo.
2. 'Nu abbonamento in corso cu' 'nu piano ca include 'a funzione «API pe' gestionali esterni». L'intera v1 — pure 'e sole letture — è riservata a chi tene chesta funzione: è 'na funzione vennuta, no 'nu accessorio d' 'o pannello.
3. 'Na chiave API generata d' 'o gestionale: admin.volleyfriends.com → Impostaziune → Chiavi API → Chiave nova.

'A chiave tene 'a forma vfk_ seguito da 40 caratteri esadecimali (44 caratteri in tutto) e vene ammustrata 'na vota sola, sùbbeto doppo 'a criazione: dint'ô database resta sulo l'impronta soja sha256, quinni nun è recuperabile 'n nisciuno modo. Se 'a pierde, revocala e generane 'na nova. Dint'all'elenco d' 'o pannello vide sulo 'o prefisso (es. vfk_9f2c), 'a data 'e criazione e chella d' 'o l'urdemo utilizzo.

3. Autenticazzione

Ogni richiesta va autenticata cu' l'header X-Api-Key. Nun servono token, login, scadenze o rinnovi: 'a chiave resta valida finché nun 'a revochi.

# 'E chiavi 'e chesta pagina so' d'esempio: sostituisci cu' 'a toja.
curl -s https://www.volleyfriends.com/api/manager-api/v1/venues   -H "X-Api-Key: vfk_9f2c41a7b83d05e6c19af4728b60d35e1c9a7f42"

Dint'all'esempi ca venono appriesso 'a chiave è letta d' 'a variabile d'ambiente VF_API_KEY, comme conviene fa' pure in produzione.

Header assente, cchiù curto 'e 12 caratteri, scanusciuto o ca appartiene a 'na chiave revocata: 'a risposta è 401 cu' chistu corpo.

{
  "error": "invalid_key",
  "message": "Chiave API mancante o non valida (header X-Api-Key)."
}

4. Base URL

https://www.volleyfriends.com/api

'E path ducumentati cca sotto vanno accudati 'a base. 'O prefisso /api appartiene ô reverse proxy, quinni l'indirizzo completo 'e 'nu endpoint è pe' esempio:

GET https://www.volleyfriends.com/api/manager-api/v1/availability

Tutte 'e risposte so' application/json cu' codifica UTF-8. 'E richieste cu' corpo (POST, PATCH) hanno da avé Content-Type: application/json.

5. Rate limiting

'O limite è 'e 120 richieste ô minuto pe' chiave API (fenesta scorrevole 'e 1 minuto). 'O cunto è pe' chiave, no pe' ndirizzo IP: 'e gestionali stanno spisso areto ô stesso ndirizzo d' 'o provider e 'nu limite pe' IP penalizzasse gestore diverse ospitate 'ncopp'â stessa nfrastruttura. Se l'header X-Api-Key manca d' 'o tutto, 'o cunto cade 'ncopp'ô ndirizzo IP.

Ogni rispuosta riporta 'o stato d' 'o cuntatore dint'e header x-ratelimit-limit, x-ratelimit-remaining e x-ratelimit-reset (seconne ô reset). Quanno se supera, se mmette pure retry-after.

Rispuosta ô superamento — 429

{
  "error": "rate_limited",
  "message": "Limite di 120 richieste al minuto superato per questa chiave API."
}

6. Endpoint

Sije endpoint, tutte sotto /manager-api/v1. Ogni chiamata passa p' 'a stessa catena 'e cuntrolle, dint'a l'ordine: chiave API valida → funzione «API per gestionali esterni» nclusa dint'ô chiano → rate limit → validazione d' 'e parametre → verfeca ca 'a risorsa è 'a toja.

6.1 Strutture e campe

Elenca 'e strutture toje, ognuna cu 'e campe suoje annidate. È 'a chiamata da addò partì: l'id d' 'e campe (courtId) servono a tutte l'ate endpoint. 'E strutture stanno ordinate pe' nomme, 'e campe pe' nomme.

Parametre

Nisciuno.

Essempio 'e richiesta

curl -s https://www.volleyfriends.com/api/manager-api/v1/venues   -H "X-Api-Key: $VF_API_KEY"

Essempio 'e rispuosta — 200

{
  "venues": [
    {
      "id": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
      "name": "Centro Sportivo Aurora",
      "city": "Verona",
      "address": "Via delle Palestre 12",
      "verified": true,
      "courts": [
        {
          "id": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
          "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
          "name": "Campo 1",
          "surface": "parquet",
          "indoor": true,
          "lighting": true
        },
        {
          "id": "e2a71f64-9c03-4bd8-b512-38f6cd90a7e1",
          "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
          "name": "Campo 2 beach",
          "surface": "sabbia",
          "indoor": false,
          "lighting": true
        }
      ]
    }
  ]
}

Campe d' 'a rispuosta

Si l'account nun tene ancora strutture 'a rispuosta è {"venues": []}.

Errure specifiche

Nisciuno oltre a chille generali.

6.2 Elenco prenotaziune

Restituisce 'e prenotaziune d' 'e strutture toe, ordinate pe' orario 'e inizio a crescere. L'elenco è paginato: a 'o massimo limit righe pe' chiamata (default 500, tetto 1000) — si riceve overamente limit righe, chiamma n'ata vota cu offset aumentato pe' 'a pagina appriesso. In produzione filtra comunque sempe ammeno pe' intervallo 'e date.

Parametri (query string)

Essempio 'e richiesta

curl -s -G https://www.volleyfriends.com/api/manager-api/v1/bookings   -H "X-Api-Key: $VF_API_KEY"   --data-urlencode "courtId=7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05"   --data-urlencode "from=2026-08-01"   --data-urlencode "to=2026-08-31"

Essempio 'e rispuosta — 200

{
  "bookings": [
    {
      "id": "9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f",
      "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
      "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
      "courtName": "Campo 1",
      "startsAt": "2026-08-12T16:00:00.000Z",
      "endsAt": "2026-08-12T17:30:00.000Z",
      "customerName": "Marta Bellini",
      "customerPhone": "+39 340 1122334",
      "customerEmail": "marta.bellini@example.com",
      "priceCents": 3000,
      "playersCount": null,
      "status": "confirmed",
      "paymentMethod": null,
      "paymentLink": null,
      "notes": "Prenotato dal sito della struttura",
      "source": "api",
      "recurrenceId": null,
      "createdAt": "2026-07-28T09:14:02.517Z",
      "updatedAt": "2026-07-28T09:14:02.517Z"
    }
  ],
  "limit": 500,
  "offset": 0
}

Campi 'e na prenotazzione

'A stessa struttura vene turnata da POST e PATCH (dinto a 'a chiave booking).

Errure specifiche

6.3 Nova prenotazione

Cria 'na prenotazione 'ncoppa a 'nu campo tujo. 'A prenotazione nasce cu source: "api", accussì dint'ô pannello se distingue da chelle mise a mano, e 'o gestore riceve 'na notifica push «Nova prenotazione» 'ncoppa a l'app.

Veneno applicate 'e stesse regole d''o pannello, dint'a l'ordine:

1. chiusura straordinaria d''a struttura dint'a data d'inizio → 409 venue_closed;
2. sovrapposizione cu n'ata prenotazione nun annullata d''o stesso campo → 409 overlap;
3. prezzo assente → calcolato d''o listino d''o campo (null se l'orario d'inizio nun cade dint'a nisciuna fascia). Se 'a fascia tene 'o prezzo a persona, serve pure playersCount: senza, 'a richiesta vene rifiutata cu 400 players_required (a meno ca nun se mposta 'nu priceCents esplicito).

'E orari d'apertura nun bloccano 'a criazione: so' 'nformativi, 'o gestore resta sovrano 'ncoppa ô campo d''o suoio. Se vuo' 'mpedì prenotaziune fore orario, controlla tu hours turnato da /availability primma 'e chiammà 'a POST.

Cuorpo d''a richiesta (JSON)

Essempio 'e richiesta

curl -s -X POST https://www.volleyfriends.com/api/manager-api/v1/bookings   -H "X-Api-Key: $VF_API_KEY"   -H "Content-Type: application/json"   -d '{
    "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
    "startsAt": "2026-08-12T18:00:00+02:00",
    "endsAt": "2026-08-12T19:30:00+02:00",
    "customerName": "Marta Bellini",
    "customerPhone": "+39 340 1122334",
    "customerEmail": "marta.bellini@example.com",
    "notes": "Prenotato dal sito della struttura"
  }'

Esempio 'e risposta — 201

{
  "booking": {
    "id": "9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f",
    "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
    "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
    "courtName": "Campo 1",
    "startsAt": "2026-08-12T16:00:00.000Z",
    "endsAt": "2026-08-12T17:30:00.000Z",
    "customerName": "Marta Bellini",
    "customerPhone": "+39 340 1122334",
    "customerEmail": "marta.bellini@example.com",
    "priceCents": 3000,
    "playersCount": null,
    "status": "confirmed",
    "paymentMethod": null,
    "paymentLink": null,
    "notes": "Prenotato dal sito della struttura",
    "source": "api",
    "recurrenceId": null,
    "createdAt": "2026-07-28T09:14:02.517Z",
    "updatedAt": "2026-07-28T09:14:02.517Z"
  }
}

Dint'a l'esempio priceCents nun era stato innecato: 90 minute 'ncoppa a 'na fascia da 20,00 €/ora danno 3000 centesime ('o calcolo è proporzionale a 'e minute effettive, cu 'a tariffa d''a fascia addò accummincia 'a prenotazione).

Errure specifiche

// 409 — sovrapposizione
{ "error": "overlap", "message": "Il campo è già prenotato in quell'orario." }

// 409 — chiusura straordinaria ('o mutivo, se nnicato d' 'o gestore, sta dint'ô messaggio)
{ "error": "venue_closed", "message": "Struttura chiusa in quella data (manutenzione)." }

6.4 Cagna prenotazione

Aggiurna 'na prenotazione ca già ce sta. È n'aggiurnamento parziale: manna sulo 'e campe ca cagnano, l'ate restano tale e quale. 'O cuorpo adda tené almanco 'nu campo.

Nun esiste n'endpoint 'e cancellazione: pe' annullà 'na prenotazione s'addorza status: "cancelled". 'O storeco resta dint'ô pannello e 'o slot turna libbero ('e prenotazzione annullate nun occupano 'o campo e nun generano overlap).

Parametro 'e percorso

Cuorpo d''a richiesta (JSON)

Tutti 'e campe so' opzionali. Chille marcate «annullabile» accettano null pe' svutà 'o valore.

Esempio 'e richiesta — spostamento e incasso

curl -s -X PATCH   https://www.volleyfriends.com/api/manager-api/v1/bookings/9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f   -H "X-Api-Key: $VF_API_KEY"   -H "Content-Type: application/json"   -d '{
    "startsAt": "2026-08-12T19:00:00+02:00",
    "endsAt": "2026-08-12T20:30:00+02:00",
    "status": "paid",
    "paymentMethod": "cash",
    "priceCents": 3000
  }'

Esempio 'e richiesta — annullamento

curl -s -X PATCH   https://www.volleyfriends.com/api/manager-api/v1/bookings/9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f   -H "X-Api-Key: $VF_API_KEY"   -H "Content-Type: application/json"   -d '{ "status": "cancelled" }'

Essempio 'e rispuosta — 200

'A prenotazione aggiurnata, dint'ô stesso formato d' 'a POST:

{
  "booking": {
    "id": "9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f",
    "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
    "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
    "courtName": "Campo 1",
    "startsAt": "2026-08-12T17:00:00.000Z",
    "endsAt": "2026-08-12T18:30:00.000Z",
    "customerName": "Marta Bellini",
    "customerPhone": "+39 340 1122334",
    "customerEmail": "marta.bellini@example.com",
    "priceCents": 3000,
    "playersCount": null,
    "status": "paid",
    "paymentMethod": "cash",
    "paymentLink": null,
    "notes": "Prenotato dal sito della struttura",
    "source": "api",
    "recurrenceId": null,
    "createdAt": "2026-07-28T09:14:02.517Z",
    "updatedAt": "2026-07-28T11:02:47.883Z"
  }
}

Errure specifiche

6.5 Disponibilità 'e 'nu campo dint'a 'nu juorno

Restituisce, pe' 'nu campo e 'nu juorno, 'e slot occupati, 'e orari 'e apertura 'e chillo juorno d' 'a settimana e l'eventuale chiusura straordinaria. È l'endpoint da ausà pe' calcolà 'e slot libbere 'ncopp'a 'nu sito esterno senza duplicà 'e regole d' 'o gestionale: sottrai 'e prenotazione d' 'a finestra 'e apertura.

Ce stanno elencate tutte 'e slot ca occupano 'o campo, in qualunque stato tranne cancelled: quinn' pure 'e richieste 'e prenotazione online ancora pending. 'O juorno è chillo locale italiano e l'intervalli so' semiaperte: 'na prenotazione ca fernisce esattamente a mezanotte appartene ô juorno primma. 'Na prenotazione a cavallo d' 'a mezanotte compare dint'a tutt'e duje 'e juorne ca interseca, cu 'e mumente riale d' 'e suoje (ca ponno cadé fore d' 'o juorno richiesto).

Parametri (query string)

Essempio 'e richiesta

curl -s -G https://www.volleyfriends.com/api/manager-api/v1/availability   -H "X-Api-Key: $VF_API_KEY"   --data-urlencode "courtId=7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05"   --data-urlencode "date=2026-08-12"

Essempio 'e rispuosta — 200

{
  "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
  "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
  "date": "2026-08-12",
  "timezone": "Europe/Rome",
  "hours": {
    "weekday": 2,
    "openMinute": 540,
    "closeMinute": 1380,
    "closed": false,
    "configured": true
  },
  "closure": null,
  "bookings": [
    {
      "startsAt": "2026-08-12T16:00:00.000Z",
      "endsAt": "2026-08-12T17:30:00.000Z",
      "status": "confirmed"
    },
    {
      "startsAt": "2026-08-12T18:00:00.000Z",
      "endsAt": "2026-08-12T19:00:00.000Z",
      "status": "paid"
    },
    {
      "startsAt": "2026-08-12T19:00:00.000Z",
      "endsAt": "2026-08-12T20:30:00.000Z",
      "status": "pending"
    }
  ]
}

Campe d' 'a rispuosta

Errure specifiche

6.6 Listino 'e 'nu campo

'O listino d' 'o campo in sola lettura: serve a mustrà 'e prezze a 'o cliente primma d' 'a prenotazzione, cu 'e stesse fasce ca 'o gestionale ausa pe' calculà 'o prezzo automatico. 'E fasce se modificano sulo d' 'o pannello. Songo urdenate pe' fromMinute crescente.

Parametri (query string)

Essempio 'e richiesta

curl -s -G https://www.volleyfriends.com/api/manager-api/v1/rates   -H "X-Api-Key: $VF_API_KEY"   --data-urlencode "courtId=7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05"

Essempio 'e rispuosta — 200

{
  "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
  "rates": [
    {
      "id": "4a1e0b72-6d35-4c81-93af-0b7e2d5814c6",
      "label": "Mattina infrasettimanale",
      "daysMask": 31,
      "fromMinute": 480,
      "toMinute": 840,
      "pricePerHourCents": 1500,
      "pricingMode": "court",
      "minPlayers": null
    },
    {
      "id": "c07d9b31-8f42-4a05-b6e9-15d3c8017a2b",
      "label": "Serale",
      "daysMask": 127,
      "fromMinute": 1080,
      "toMinute": 1380,
      "pricePerHourCents": 600,
      "pricingMode": "person",
      "minPlayers": 10
    }
  ]
}

Campe d' 'a rispuosta

Errure specifiche

'Nu campo senza listino risponne 200 cu "rates": [].

7. Cunvenziune d''e date

7.1 Date e orare

• In ingresso l'istante songo stringhe ISO 8601 cu offset obbricatorio: 2026-08-12T18:00:00+02:00 oppure 2026-08-12T18:00:00Z. 'Na stringa senza offset (2026-08-12T18:00:00) vene refutata cu 400: sarrìa ambigua, e pe' 'nu calannario è 'n'ambiguità ca se pava cu prenotazzione sbagliate 'e n'ora.
• In uscita l'istante songo sempe nurmalizzate in UTC cu suffisso Z e milliseconne: "2026-08-12T16:00:00.000Z". Cunvertile dint'ô fuso lucale primma 'e amustrà.
• 'E date sicche (date, closure.from, closure.to, e from/to quanno l'use a forma 'e juorno) songo AAAA-MM-GG e se referiscono ô juorno lucale taliano.
• L'intervalle songo semiaperte [inizio, fine): 18:00–19:00 e 19:00–20:00 nun stanno in cunflitto.

7.2 Fuso orario

'E prenotazzione songo cunservate comme istante assolute, ma tutte 'e regule 'e calannario — juorno d''a semmana, fasce d''o listino, orare 'e apertura, date 'e chiusura, cunfine d''o juorno — songo valutate dint'ô fuso Europe/Rome, cu l'ora legale gestita automaticamende. 'O campo timezone d''a rispuosta 'e /availability 'o dichiara esplicitamende. Se 'o server tujo gira in UTC o dint'a n'ato fuso, nun cunvertì a mano 'e minute: songo ggià espresse in ora lucale taliana.

7.3 Minute d''a mezanotte

L'orare «da calannario» (openMinute, closeMinute, fromMinute, toMinute) songo nummere 'ntere da 0 a 1440 ca cuntano 'e minute d''a mezanotte lucale. Cunversione: ore = ⌊m / 60⌋, minuti = m mod 60.

7.4 Importe

Tutte l'importe songo nummere 'ntere in centesime 'e euro (priceCents, pricePerHourCents): nisciuno valore cu 'a virgula, nisciuno simmolo 'e valuta. 2000 = 20,00 €. 'Ncoppa a 'na prenotazzione, priceCents: null significa «prezzo a definì» ed è deverzo da 0, ca significa «gratis».

7.5 State 'e 'na prenotazzione

7.6 Origgine e metodo 'e pavamento

Tutt'e duje songo domini testuali: nuove valure ponno essere aggiunte 'n futuro senza cagnà versione, quinni 'o codice tujo nun adda jì 'n errore 'ncopp'a 'nu valore ca nun canosce.

7.7 Date personale d''e cliente

Nomme, telefono ed email ca manne dint'e prenotazzione songo date personale d''e cliente tuoje: si' tu 'o titolare d''o trattamento, VolleyFriends 'e cunserva pe' cunto tujo comme responsabile ai sensi dell'art. 28 GDPR. Manna sulo chello ca serve a 'a gestione d''o campo e informa 'e cliente tuoje. 'O dettaglio sta dint'a privacy policy.

8. Errore generale

Ogni errore tene 'o stesso cuorpo: 'nu codice stabile dint'a error, pensato p' 'o codice tujo, e 'nu message in italiano, pensato p' 'e ggenti. Piglia 'e decisioni toje 'ncopp'a error e 'ncopp'ô stato HTTP, no 'ncopp'ô testo d' 'o messaggio, ca pô cagnà.

{
  "error": "overlap",
  "message": "Il campo è già prenotato in quell'orario."
}

'E ll'errore 'e validazione azzongono issues, 'a lista dettagliata d' 'e prubleme campo pe' campo:

{
  "error": "invalid_input",
  "message": "Dati non validi",
  "issues": [
    {
      "code": "invalid_string",
      "validation": "datetime",
      "path": ["startsAt"],
      "message": "Invalid datetime"
    }
  ]
}

'Nu path ca nun esiste sotto 'a base risponne 404; 'a stessa cosa vale pe' 'nu metodo ca nun è previsto 'ncoppa a 'nu path ca esiste:

{
  "error": "not_found",
  "message": "Risorsa non trovata"
}

'E risposte 502, 503 e 504 arrivano d' 'o reverse proxy quanno l'API nun se pò raggiongere (riavvio o manutenzione): dint'a chillu caso 'o cuorpo nun è garantito in formato JSON. Trattale comme a errore temporanee e pruove n'ata vota cu 'o backoff, senza pruvà a sutterrà 'o cuntenuto.

9. Versioni e compatibilità

'A versione sta dint' 'o path: /manager-api/v1. Nun ce stanno header 'e versione né date 'e release da specificà: l'unica versione ca sta mo' pubblicata è v1.

Che cosa possiamo cambiare senza avvisarti

• Aggiungere campi alle risposte esistenti.
• Aggiungere parametri opzionali alle richieste, con un valore predefinito che conserva il comportamento attuale.
• Aggiungere nuovi endpoint sotto /v1.
• Aggiungere valori ai campi testuali aperti (source, paymentMethod, surface).
• Riformulare i message degli errori, mantenendo invariati i codici error.

Che cosa non cambia dentro la v1

• Nessun campo verrà rimosso o rinominato dalle risposte.
• Nessun campo cambierà tipo o significato.
• Nessun parametro oggi opzionale diventerà obbligatorio.
• I codici error e gli stati HTTP documentati qui restano quelli.

Qualunque modifica che rompa queste garanzie arriverà su un nuovo prefisso (/v2), con la v1 mantenuta in servizio e un preavviso ai gestori che la stanno usando.

Changelog

10. Supporto a l'integrazzione

Pe' dumande tecniche, cumportamente ca nun t'aspette o richieste 'e endpoint ca nun truove ccà, scrivice d'a paggena Contatte. Pe' ghjì deritto ô punto, scrive dint'ô messaggio:

• endpoint e metodo ca staje chiammanno;
• data e ora d'a chiamata (cu 'o fuso) e 'o codice HTTP arricivuto;
• codice error e messaggio d'a risposta;
• prefisso d'a chiave ausata (es. vfk_9f2c).

Si haje bisogno 'e pruvà l'integrazzione senza tuccà 'o calannario reale, crija 'na struttura 'e prova cu 'nu campo dedicato e ausa chella: tutte 'e chiammate so' limitate a 'e strutture d'o pruprietario d'a chiave, accussì 'o riesto d'o cunto tujo nun è cuinvolto.