API Partenaire

L’API Partenaire Wink est la méthode authentifiée, à plus haut débit, permettant aux intégrateurs d’interroger l’inventaire de voyages réservables — le même stock qui alimente nos widgets intégrables et les points d’accès publics de navigation, exposé comme une interface programmatique de première classe. Alors que les Web Components gratuits et les points d’accès publics de navigation sont destinés à une intégration légère et orientée utilisateur, l’API Partenaire est conçue pour les systèmes qui recherchent, tarifient et réservent à grande échelle. L’accès est authentifié par intégrateur et facturé à l’usage, vous ne payez donc que pour le trafic que vous générez réellement.

Plans & tarification

L’utilisation est mesurée en nuits d’hôtel : un hôtel tarifé pour une nuit de séjour — pas un appel API. Une recherche qui retourne 20 hôtels pour un séjour de 3 nuits correspond à 60 nuits d’hôtel pour une seule requête. Les appels Content et Lookup (recherche de destination et autocomplétion) font exception : chacun coûte une unité par appel, quel que soit le résultat. Les points d’accès Account sont gratuits. La tarification est la source de vérité pour le tarif.

	Gratuit	Payant	Entreprise
Prix	0 $	Basé sur l’usage	Contactez-nous
Idéal pour	Évaluation & intégrations à faible volume	Débit à la demande à grande échelle	Volume personnalisé & conditions négociées
Unités par mois	10 000	Illimité	Illimité
Temps de réponse API (P95)	—	Moins de 500 ms	Moins de 500 ms
Prix par unité (nuit d’hôtel)	Gratuit	0,0001 $	Personnalisé
Réponse à la limite mensuelle	429 jusqu’au 1er du mois suivant (UTC)	Facturé, non bloqué	Selon accord
Accord de niveau de service	—	✓	✓
Support prioritaire	—	✓	✓
Intégration dédiée	—	—	✓

Obtenir une clé API · Démarrer la facturation à l’usage · Contacter les ventes

Référence API

Deux interfaces desservent l’inventaire réservable, correspondant aux deux niveaux ci-dessus :

• Gratuit — API Consommateur / Moteur de Réservation (REST, /api/public/**) : anonyme, orienté navigateur et widget. Consulter la référence du Moteur de Réservation →
• Payant — API Intégrateur Partenaire (gRPC, wink.partner.v1) : authentifié, facturé à l’usage, conçu pour l’intégration serveur à serveur à grande échelle. Consulter la référence Intégrateur →

L’API Intégrateur Partenaire est gRPC, pas REST. Vous l’appelez avec un client généré via HTTP/2 à partner.wink.travel:443, en passant un jeton bearer et le compte pour lequel vous appelez :

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

La page de référence ci-dessus documente chaque service, message et statut d’erreur, et le schéma est aussi disponible à l’exécution via la réflexion serveur, donc grpcurl, Postman et Insomnia le découvrent sans rien à télécharger.

Si vous préférez générer un client à l’avance, les fichiers source .proto sont publiés sur github.com/wink-travel/partner-api-proto.

Fonctionnement de l’usage et des limites

Niveau gratuit

Le niveau Gratuit est conçu pour vous permettre de construire, tester et exécuter un trafic de production modeste sans frais.

• Pas de limite par minute publiée. Wink surveille les taux de requêtes et peut appliquer des limites d’usage équitable pour protéger le service. Si vous recevez un HTTP 429 (Trop de requêtes), attendez le nombre de secondes indiqué dans l’en-tête Retry-After avant de réessayer.
• Allocation mensuelle — 10 000 unités par mois calendaire. L’allocation est accordée par compte et se réinitialise le 1er de chaque mois (UTC). Une fois atteinte, un compte non inscrit à la facturation à l’usage reçoit un HTTP 429 jusqu’au 1er du mois suivant — un arrêt net, avec un en-tête Retry-After et un message invitant à souscrire au niveau Payant. Un compte inscrit continue de fonctionner et est facturé pour l’usage au-delà de l’allocation.

Le niveau Gratuit n’inclut pas d’accord de niveau de service ni de support prioritaire.

Niveau payant

Le niveau Payant supprime le plafond mensuel et vous facture uniquement ce que vous utilisez.

• Nuits d’hôtel mesurées — 0,0001 $ par nuit d’hôtel. Il n’y a pas de plafond mensuel ; vous êtes facturé sur le volume réel. Wink peut toujours appliquer des limites d’usage équitable pour protéger le service. Les appels de recherche et d’inventaire sont facturés par nuit d’hôtel tarifée ; les appels Content et Lookup facturent une unité chacun, donc regrouper vos requêtes réduit la facture.

Le niveau Payant inclut l’accord de niveau de service décrit ci-dessous — un engagement de disponibilité à 99,9 % et un objectif de temps de réponse P95 sous 500 ms — ainsi qu’un support prioritaire basé sur la gravité.

Accord de niveau de service

Date d’entrée en vigueur : 5 juillet 2026 · Version 1.0

Cet Accord de niveau de service (le “SLA”) définit l’engagement de disponibilité, les crédits de service et les objectifs de support que Wink (“Wink”, “nous”) fournit à un client (“Client”, “vous”) pour l’API Partenaire Wink authentifiée (l‘“API Partenaire” ou le “Service”) sur les niveaux où un SLA est indiqué comme applicable. Ce SLA est incorporé et régi par l’accord entre vous et Wink sous lequel vous accédez à l’API Partenaire (l‘“Accord”), et s’applique tant que vous maintenez un abonnement actif et payant à l’API Partenaire en règle. Les termes en majuscules non définis ici ont la signification qui leur est donnée dans l’Accord.

1. Définitions

1. “Disponibilité” désigne les périodes pendant lesquelles l’API Partenaire est disponible pour accepter et répondre avec succès à des requêtes correctement formées et authentifiées.
2. “Indisponibilité” désigne toute période, mesurée en minutes, pendant laquelle l’API Partenaire ne répond pas avec succès à des requêtes correctement formées et authentifiées, à l’exclusion de toute période relevant des exclusions définies à la Section 4. Les erreurs isolées affectant une fraction non significative des requêtes ne constituent pas, en elles-mêmes, une Indisponibilité.
3. “Pourcentage de disponibilité mensuel” désigne, pour un mois calendaire donné, le nombre total de minutes dans ce mois moins le total des minutes d’Indisponibilité, divisé par le nombre total de minutes dans ce mois, exprimé en pourcentage.
4. “Maintenance planifiée” désigne la maintenance prévue du Service pour laquelle Wink a fourni un préavis conformément à la Section 4.
5. “Crédit de service” désigne un crédit, calculé en pourcentage des frais payés ou payables par vous pour l’API Partenaire durant le mois calendaire concerné, qui est appliqué aux frais futurs de l’API Partenaire comme seul et unique recours en cas de non-respect de l’engagement de disponibilité.
6. “Temps de réponse” désigne le temps écoulé entre la réception par Wink d’une requête correctement formée et authentifiée à la frontière de service de Wink et le moment où Wink commence à renvoyer la réponse, hors transit réseau et tout temps côté client hors du contrôle de Wink.

2. Engagement de disponibilité & performance

Wink s’engage à faire en sorte que l’API Partenaire soit disponible avec un pourcentage de disponibilité mensuel d’au moins 99,9 % durant chaque mois calendaire de la durée (l‘“Engagement de disponibilité”). L’engagement de disponibilité est mesuré à la frontière de service de Wink et exclut tout facteur hors du contrôle raisonnable de Wink, y compris ceux décrits à la Section 4. Les systèmes de surveillance de Wink sont la source de référence pour mesurer le pourcentage de disponibilité mensuel et le temps de réponse.

Wink vise également un temps de réponse au 95e percentile (P95) inférieur à 500 millisecondes pour les requêtes réussies, correctement formées et authentifiées, mesuré à la frontière de service de Wink sur chaque mois calendaire (l‘“Objectif de performance”). L’objectif de performance exclut les facteurs décrits à la Section 4, les requêtes retournant des erreurs au niveau applicatif causées par la requête elle-même, ainsi que les requêtes batch exceptionnellement grandes ou complexes. L’objectif de performance est un objectif de service ; les crédits de service de la Section 3 s’appliquent aux manquements à l’Engagement de disponibilité et constituent le seul et unique recours en cas de défaillance de disponibilité.

3. Crédits de service

Si le pourcentage de disponibilité mensuel est inférieur à l’engagement de disponibilité durant un mois calendaire, vous pouvez être éligible à un crédit de service calculé en pourcentage des frais de l’API Partenaire payés ou payables par vous pour ce mois, selon l’échelle suivante :

Pourcentage de disponibilité mensuel	Crédit de service
Inférieur à 99,9 % mais au moins 99,0 %	10 %
Inférieur à 99,0 % mais au moins 95,0 %	25 %
Inférieur à 95,0 %	50 %

1. Réclamation d’un crédit. Pour recevoir un crédit de service, vous devez soumettre une réclamation écrite à Wink dans les trente (30) jours suivant la fin du mois calendaire où le manquement est survenu. La réclamation doit inclure les dates et heures de chaque incident d’indisponibilité réclamé ainsi que tout journal ou preuve raisonnablement disponible. Les réclamations soumises après ce délai ne sont pas éligibles.
2. Forme du crédit. Les crédits de service approuvés sont appliqués aux frais futurs de l’API Partenaire et n’ont aucune valeur monétaire. Ils ne sont pas des remboursements et ne seront pas versés, sauf si la loi applicable l’exige.
3. Crédit maximal. Le total des crédits de service accordés pour un même mois calendaire ne dépassera pas 50 % des frais de l’API Partenaire payés ou payables par vous pour ce mois.
4. Recours unique et exclusif. Les crédits de service constituent votre recours unique et exclusif pour tout manquement de Wink à l’engagement de disponibilité ou toute autre défaillance de disponibilité de l’API Partenaire.

4. Exclusions

L’engagement de disponibilité et les crédits de service qui en découlent ne s’appliquent pas, et l’indisponibilité n’inclut pas, toute indisponibilité, suspension, dégradation ou problème de performance résultant de ou lié à :

1. Maintenance planifiée pour laquelle Wink a donné un préavis, à condition que ce préavis soit donné dans un délai raisonnable par un canal que Wink utilise normalement pour communiquer avec les clients ;
2. Force majeure ou autres causes hors du contrôle raisonnable de Wink, y compris catastrophes naturelles, actes gouvernementaux, pannes de réseau ou d’utilitaires, et attaques par déni de service ou autres attaques malveillantes ;
3. problèmes causés par vos actes ou omissions, votre équipement, logiciel ou réseau, ou par tout service, produit ou fournisseur tiers non sous le contrôle direct de Wink ;
4. votre abus du Service ou violation de l’Accord, de ce SLA, des conditions d’utilisation acceptables ou des limites de taux applicables, y compris un trafic que Wink juge raisonnablement excessif, un abus automatisé ou frauduleux ; et
5. toute suspension ou résiliation de votre accès effectuée conformément à l’Accord, y compris suspension pour non-paiement.

5. Support & objectifs de réponse

Wink fournit un support pour l’API Partenaire pendant les heures ouvrables standard, hors jours fériés locaux. Wink s’efforcera raisonnablement d’accuser réception des demandes de support correctement soumises dans les délais cibles suivants, basés sur la gravité que vous attribuez et que Wink confirme raisonnablement :

Gravité	Description	Délai cible de réponse initiale
Sev 1 — Critique	L’API Partenaire est indisponible ou inutilisable en production sans solution de contournement.	4 heures
Sev 2 — Majeure	Fonctionnalité significative dégradée ou altérée ; une solution de contournement existe.	1 jour ouvrable
Sev 3 — Mineure	Questions générales, problèmes mineurs ou demandes de fonctionnalités.	2 jours ouvrables

Les délais cibles de réponse décrivent quand Wink vise à établir le premier contact ; ils ne garantissent pas un délai de résolution. Le support prioritaire et les objectifs basés sur la gravité s’appliquent aux niveaux où ils sont indiqués comme inclus.

6. Données & sécurité

Wink maintient des mesures administratives, techniques et organisationnelles commercialement raisonnables conçues pour protéger la confidentialité, l’intégrité et la disponibilité des données traitées via l’API Partenaire, et révise périodiquement ces mesures. Le traitement des données personnelles par Wink est régi par la Politique de confidentialité et toute clause de traitement des données dans l’Accord. Vous restez responsable de la sécurisation de vos propres identifiants API, de l’utilisation légale des données que vous récupérez, et de notifier rapidement Wink de toute compromission suspectée des identifiants.

7. Limitation de responsabilité

Les crédits de service sont le recours unique et exclusif pour toute indisponibilité ou manquement à l’engagement de disponibilité, et sont fournis en lieu et place de toute autre responsabilité découlant de ce manquement. Sauf indication expresse dans ce SLA, l’API Partenaire est fournie “en l’état”. Dans la limite maximale permise par la loi applicable, la responsabilité globale de Wink découlant du Service est limitée comme indiqué dans l’Accord, et Wink n’est pas responsable des dommages indirects, accessoires, spéciaux, consécutifs ou punitifs, ni des pertes de profits, revenus, données ou réputation, même averti de la possibilité de tels dommages.

8. Durée, modifications & résiliation

Ce SLA s’applique tant que vous disposez d’un abonnement actif à l’API Partenaire sur un niveau où le SLA est indiqué comme applicable. Wink peut mettre à jour ce SLA de temps à autre ; les modifications importantes seront communiquées via un canal que Wink utilise normalement pour joindre les clients, et la poursuite de l’utilisation de l’API Partenaire après la prise d’effet d’une mise à jour constitue une acceptation du SLA mis à jour. Ce SLA prend fin automatiquement à la résiliation ou à l’expiration de l’Accord ou de votre abonnement à l’API Partenaire. Les sections qui, de par leur nature, doivent survivre à la résiliation — y compris l’éligibilité aux crédits de service accumulés mais non réclamés, la limitation de responsabilité et les définitions — survivent.