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 :

Häufig gestellte Fragen

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

Anleitung 
12
  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

Anleitung 
13
  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
	}
}

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