ARCO Widget WS

Integrazione tesseramento in modalità widget

Questa pagina riepiloga i dettagli tecnici necessari per integrare il Web Service ARCO in modo rapido e sicuro. Sono mostrati solo endpoint pubblici, parametri di configurazione e campi funzionali.

Endpoint API

https://tesseramento.arco.lgbt/api/widget/registra

Lingue disponibili

5 (it, en, es, fr, de)

Dettagli WS non sensibili

Specifiche utili per embedding, invio form e personalizzazione tema.

Safe by design
Widget endpoint
https://widget.arco.lgbt/widget.php
Submit endpoint (POST)
https://tesseramento.arco.lgbt/api/widget/registra
Development API: https://prisma.arco.lgbt/api/widget/registra (usa ?env=dev)

Parametri GET richiesti

  • t: Token cifrato del widget (fornito dal sistema host)
  • lang: Lingua interfaccia (default: it)

Parametri GET opzionali (tema/preview)

  • club_name: Override nome club in preview
  • bg: Colore sfondo card/widget
  • fg: Colore testo principale
  • lc: Colore label
  • ibg: Colore sfondo input
  • ic: Colore testo input
  • bp: Colore bottone primario
  • bs: Colore testo bottone secondario
  • tpc: Colore testo bottone primario
  • env: Ambiente endpoint: prod (default) oppure dev

Campi payload inviati all'API

  • nome
  • cognome
  • data_nascita (YYYY-MM-DD)
  • sesso
  • stato_nascita
  • luogo_nascita_form_datalist
  • cittadinanza
  • tipo_documento
  • num_documento
  • stato_residenza
  • luogo_residenza_form_datalist
  • email
  • telefono
  • accetto_statuto
  • accetto_privacy
  • accetto_condizioni
  • id_locale
  • lang
  • widget_token

Esempio iframe

<iframe src="https://widget.arco.lgbt/widget.php?t=TOKEN_WIDGET&lang=it&env=prod&bg=%23ffffff&bp=%23f1416c"></iframe> <iframe src="https://prisma.arco.lgbt/widget.php?t=TOKEN_WIDGET&lang=it&env=dev"></iframe>

Flusso operativo consigliato

  • 1. Generare il token widget dal sistema host e passarlo nel parametro t.
  • 2. Impostare lang in base alla lingua utente (fallback automatico su it).
  • 3. Personalizzare i colori del form con i parametri opzionali, mantenendo il contrasto accessibile.
  • 4. Inviare i dati raccolti verso l'endpoint API via POST, con validazioni lato server.
Nota di sicurezza: questa documentazione include solo informazioni pubbliche di integrazione. Non vengono esposti token reali, segreti applicativi o credenziali operative.
Logo ARCO

ARCO - Widget Integration Snapshot