L'API Ginto

Ultimo aggiornamento:
31/10/2026
API
app
Web
Prima di iniziare

Die API ist geschützt und kann nur aufgerufen werden, wenn die Anfrage über einen API-Schlüssel authentifiziert wird. Dieser muss in jeder Anfrage als „Bearer Token“ im Autorisierungs-Header angegeben werden. Wende dich an support@ginto.guide, um einen API-Schlüssel für die Autorisierung zu erhalten.

nota

Hast du schon eine Schnittstelle zu einer unserer Partnerorganisationen, zum Beispiel zum AccommoDataHub von HotellerieSuisse? Dann kannst du bestimmte Informationen zur Barrierefreiheit, wie die Weblinks von Ginto oder die Piktogramme, auch von dort abrufen.

Consiglio professionale

Nutze unseren Ginto-Test-Workspace auf Postman, um die verschiedenen Abfragen auszuprobieren.

Ecco cosa troverai in questa guida:

Richiedere il certificato OK:GO per la partecipazione a «Swisstainable»
Domande frequenti

Introduzione alle API

    ‍

    Inviare una richiesta API

      Autorizzazione API

        Sostituisci {apiKey} con la tua chiave personale, senza le parentesi graffe.

        Test delle API con Postman

          Cliccando su questo link la raccolta di richieste di Ginto verrà clonata automaticamente e potrai iniziare a esplorare l'API di Ginto.

          Per impostare la chiave API in Postman, apri l'ambiente production e crea la variabile apiKey inserendo la tua chiave API effettiva. Successivamente, attiva l'ambiente. Ora sei pronto per inviare una richiesta.

          Postman può essere utilizzato online o scaricato gratuitamente. Qui trovi una guida dettagliata per la creazione di query GraphQL in Postman.

          API - Impostazione della lingua

            API - Panoramica delle richieste

              Schema API

                La maggior parte delle applicazioni GraphQL può recuperare automaticamente lo schema tramite Introspection e offrire le seguenti funzionalità:

                • Completamento automatico per campi e argomenti
                • Documentazione in linea di tutte le query e i campi disponibili
                • Validazione delle query prima dell'invio delle richieste

                Strumenti come Postman, Bruno, Insomnia e molte IDE GraphQL supportano questa funzione in modo nativo e visualizzano la documentazione dello schema direttamente all'interno dei propri software.

                API - Paginazione

                  Esempio di API

                    ‍

                    Richiedere la certificazione OK:GO per «Swisstainable»

                    OK:GO è riconosciuto come prova nell'ambito del programma di sostenibilità «Swisstainable» di Livello II - impegnato (in combinazione). Puoi trovare una panoramica di tutti i certificati di sostenibilità riconosciuti Webseite des STV.

                    Un certificato di partecipazione OK:GO a «Swisstainable» può essere richiesto tramite questo modulo web. Un certificato viene rilasciato quando sono soddisfatte le condizioni di partecipazione. Il certificato OK:GO è valido per due anni dalla data di emissione.
                    Grazie, abbiamo ricevuto la tua richiesta e ti risponderemo nei prossimi giorni.
                    Oh, qualcosa non ha funzionato là fuori. Per favore riprova

                    Domande frequenti

                    L'API di Ginto è a pagamento. Posso ottenere i dati anche gratuitamente?

                    Sì, è possibile. Su https://assets.ginto.guide/snapshots/entries.json.gz mettiamo a disposizione un'esportazione gratuita dei dati con cadenza settimanale.

                    Il nostro consiglio per una maggiore flessibilità: con un abbonamento a Ginto Studio+ puoi utilizzare la nostra potente API GraphQL. In questo modo avrai accesso in tempo reale a tutte le modifiche o integrazioni e potrai filtrare le tue query in modo mirato. Inoltre, con Ginto Studio+ puoi inserire i tuoi ID proprietari e recuperarli successivamente tramite l'API GraphQL. Ciò ti consente di associare facilmente le informazioni sull'accessibilità di Ginto ai tuoi sistemi.

                    Potrebbe interessarti anche questo