Utente corrente, appartenenze e permessi

GET

/api/admin/v1/auth/me

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://example.com/api/admin/v1/auth/me"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("cookie", "arenile_session=<arenile_session>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

const url = 'https://example.com/api/admin/v1/auth/me';
const options = {method: 'GET', headers: {cookie: 'arenile_session=<arenile_session>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/admin/v1/auth/me \
  --cookie arenile_session=<arenile_session>

Authorizations

cookieAuth
bearerAuth

Responses

200

Utente corrente

application/json

object

principal_type

required

string

Allowed values: user api_key

user

object

required

string format: uuid

email

required

string

name

required

string

locale

required

string

totp_enabled

required

boolean

last_login_at

string format: date-time

api_key

object

required

string format: uuid

name

required

string

prefix

required

string

establishment_id

required

string format: uuid

scopes

required

Array<string>

Allowed values: establishment.configure users.manage payments.configure bookings.write cash.operate refunds.issue operations.run bookings.read reports.read

device

Dispositivo con cui è autenticata la richiesta (solo con token per dispositivo).

object

required

string format: uuid

name

required

string

establishment_id

required

string format: uuid

memberships

required

Array<object>

object

organization_id

required

string format: uuid

establishment_id

Assente quando il ruolo vale per tutti gli stabilimenti dell’organizzazione.

string format: uuid

role

required

string

Allowed values: owner manager cashier beach_staff viewer

permissions

required

Array<string>

Allowed values: establishment.configure users.manage payments.configure bookings.write cash.operate refunds.issue operations.run bookings.read reports.read

totp_enrolment_required

required

Vero quando l’installazione richiede il TOTP ai proprietari e l’utente non lo ha ancora attivato: finché resta vero sono consentite solo le operazioni di autenticazione.

boolean

Example

{
  "principal_type": "user",
  "api_key": {
    "scopes": [
      "establishment.configure"
    ]
  },
  "memberships": [
    {
      "role": "owner",
      "permissions": [
        "establishment.configure"
      ]
    }
  ]
}

401

Autenticazione assente o non valida

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

Allowed values: bad_request validation_failed unauthorized invalid_credentials totp_required invalid_totp totp_enrolment_required totp_already_enabled forbidden csrf_failed not_found conflict method_not_allowed unsupported_media_type rate_limited idempotency_key_reused idempotency_in_progress internal_error spot_unavailable no_price policy_violation hold_expired version_conflict precondition_required spot_has_future_allocations not_implemented pool_exhausted quota_exceeded invalid_transition cash_session_closed cash_session_already_open booking_outside_period checkout_not_found payment_provider_unavailable webhook_signature_invalid pairing_code_invalid lan_mode_required loopback_required setup_token_invalid setup_completed renewal_expired waitlist_offer_expired waitlist_disabled credit_insufficient season_rollover_conflict test_mode_preview_required import_invalid import_already_applied refund_in_progress zone_full assignment_conflict ticket_number_conflict ticket_voided ticket_already_entered price_changed ticket_owned printing_unavailable printer_address_not_allowed print_route_missing payment_provider_test_mode email_template_invalid

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}