L'API Ginto (GraphQL)

Dernière mise à jour : 
5/9/2025
API
appli
Web
Avant de commencer

L'API est protégée et ne peut être invoquée que si la demande est authentifiée à l'aide d'une clé API. Cela doit être spécifié en tant que jeton porteur dans l'en-tête d'autorisation à chaque demande. Contactez support@ginto.guide pour obtenir une clé d'API pour l'autorisation de l'API.

note

Si vous disposez déjà d'une interface avec l'une de nos organisations partenaires, par exemple l'AccommoDataHub d'Hotellerie Suisse, vous pouvez également y obtenir des informations.

Conseil professionnel

Utilisez notre espace de travail de test Ginto dans Postman pour tester les différentes requêtes.

C'est ce que vous trouverez dans ce guide :

Demandez un preuve OK:GO pour «Swisstainable»
Questions fréquemment posées

Récupérez les entrées par coordonnées et par noms

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
{
    entriesBySearch(lat: 47.4224806, lng: 9.3760095, query: "palace", within: 5) {
        totalCount
        pageInfo {
            hasNextPage
            endCursor
        }
        edges {
            node {
                id
                name
								position {
                    street
                    housenumber
                    postcode
                    city
                    lat
                    lng
                }
                publication {
                    iconUrl
                    iconTextDE: iconText(locale: DE)
                    iconTextFR: iconText(locale: FR)
                    iconTextIT: iconText(locale: IT)
                    iconTextEN: iconText(locale: EN)
                    linkUrl
                    linkTextDE: linkText(locale: DE)
                    linkTextFR: linkText(locale: FR)
                    linkTextIT: linkText(locale: IT)
                    linkTextEN: linkText(locale: EN)
                }
            }
        }
    }
}

Pour demander les 50 entrées suivantes, nous prenons le endCursor de la réponse précédente et le définissons comme argument after de la requête suivante comme suit :

Catégorie et groupe de catégories

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5

Cela vous donne un aperçu de toutes les catégories et groupes de catégories disponibles :

AllEntries {
	availableCategories {
    	groupKey
		groupName
		key
		name
	}
}

Voici comment obtenir la catégorie et le groupe de catégories d'une entrée spécifique :

AllEntries {
	entry(entryId: "8f62bea4-b778-46e2-ac49-dda6a4ef2680") {
	name
	categories {
		groupKey
		groupName
		key
		name
	}
}

Demandez un preuve OK:GO pour «Swisstainable»

OK:GO est reconnu comme une preuve dans le cadre du programme de durabilité «Swisstainable» de niveau II - engaged (en combinaison). Vous trouverez un aperçu de tous les certificats de durabilité reconnus ici.

Un certificat OK:GO de participation à «Swisstainable» peut être demandé via ce formulaire en ligne. Un certificat est délivré lorsque les conditions de participation sont remplies. Le certificat OK:GO est valide pendant deux ans à compter de la date d'émission.
Merci, nous avons bien reçu votre demande et nous vous répondrons dans les prochains jours.
Oh, quelque chose n'a pas marché là-bas. Veuillez réessayer

Questions fréquemment posées

Il n'existe actuellement aucune question fréquemment posée à propos de ce guide.

Cela pourrait également vous intéresser