À propos du projet

tarkov-data-overlay est une superposition de corrections et d'ajouts de données maintenue par la communauté pour l'API tarkov.dev. La motivation déclarée est que les mises à jour du jeu peuvent être plus rapides que les mises à jour des données ; le projet comble donc cette lacune de deux manières : en corrigeant les valeurs incorrectes, telles que les niveaux de quête ou les exigences de carte, et en ajoutant des types de données que l'API source ne contient pas, comme les éditions du jeu. Utilisation La superposition est publiée sous forme de fichier JSON et récupérée via le CDN jsDelivr. Les consommateurs la fusionnent avec les réponses de tarkov.dev. Le README conseille de fixer un tag de version immuable ou un commit pour l'utilisation en production, car l'URL d'une branche suit l'état évolutif du dépôt ; le condensat intégré peut détecter la corruption ou les données obsolètes, mais ne prouve pas l'authenticité d'une réponse du CDN. Les détails d'intégration se trouvent dans un guide d'intégration, avec des documents distincts couvrant la disponibilité des quêtes et le suivi de l'état de déblocage ainsi qu'un contrat de données de compteur ; un helper evaluateTaskProgression est référencé pour les compteurs basés sur la progression vérifiée et les résultats inconnus explicites. Surveillance Un moniteur hébergé est disponible, et ce même moniteur peut être exécuté localement via un script npm. Il est en lecture seule par défaut. Une action locale « Update overlay » nécessite une acceptation explicite avec un jeton de reconstruction, et les reconstructions exigent toujours un jeton non vide transmis dans un en-tête Authorization Bearer. Le serveur se lie par défaut à la boucle locale ; un lien ailleurs est recommandé uniquement derrière un proxy inverse ou une limite réseau de confiance. Lorsque le HTTPS est terminé par un proxy de confiance, un indicateur distinct active les reconstructions, et dans ce mode, les quotas de flux d'événements par client utilisent la première adresse X-Forwarded-For valide, le proxy devant donc écraser cet en-tête. Les reconstructions ciblent le chemin de sortie par défaut de la superposition ; les cibles de superposition locales et HTTP(S) personnalisées restent en lecture seule. Maintenance Une commande check-overrides compare toutes les substitutions aux données actuelles de l'API et signale celles qui sont toujours nécessaires, les corrections qui ont été résolues à la source et peuvent être supprimées, les quêtes ayant disparu de l'API, et les régressions de qualité des données source. Le signalement est le comportement par défaut ; trois portes d'accès optionnelles contrôlent le comportement en cas d'échec, avec des codes de sortie distincts pour les vérifications d'incohérence strictes, les données obsolètes que la source fournit désormais (la porte exécutée dans la CI), et les régressions de la source. La porte source est délibérément exclue de la CI car de tels problèmes proviennent des données de tarkov.dev et ne peuvent être résolus depuis ce dépôt. La validation locale, la vérification des types et les tests sont exécutés via des scripts npm distincts. Gouvernance et contribution Des guides de contribution et de triage sont fournis. Le projet se décrit comme étant maintenu par la communauté et fourni « au mieux », exige des preuves telles que des liens wiki ou des captures d'écran pour les corrections, se présente comme un pont pendant les lacunes de données plutôt que comme un remplacement de tarkov.dev, et conserve un historique transparent via Git. Les conditions de licence se trouvent dans le fichier LICENSE du dépôt.