Developer Tools: API

Interface de programmation (API)

L'interface de programmation d'application (API) BibleSearch permet à tout développeur d'intégrer du contenu et du texte biblique n'importe où dans son site web ou son application, à des fins non commerciales. Si vous n'êtes pas développeur, et que vous souhaitez intégrer du contenu biblique ou BibleSearch dans votre site web, essayez quelques-uns de nos utilitaires ici. Pour vous qui êtes développeur, l'API BibleSearch est une API basée sur REST, et la documentation complète est accessible ici.

Merci de prendre connaissance de la rubrique FAQ suivante pour comprendre comment utiliser l'API BibleSearch. Pour toute question, sentez-vous libre de passer sur notre forum API pour poster une question. Vous pouvez également nous envoyer un courriel à support@bibles.org en indiquant API dans la ligne objet.

Comment accéder à l'API ?

Pour accéder à l'API, vous devez être enregistré comme utilisateur de BibleSearch et avoir activé votre clé API personnelle en vous inscrivant ici. Une fois que vous êtes en possession de votre clé API, vous pouvez faire des demandes à l'API et récupérer des contenus. N'oubliez pas que toute demande de votre part doit comprendre cette clé API. Votre clé API vous est personnelle. Elle est secrète ; ne la partagez donc avec personne !

Comment utiliser les données ?

Vous n'êtes pas autorisé à utiliser les contenus bibliques récupérés de l'API à des fins commerciales, ni dans aucune application illégale, choquante, obscène, violente, immorale, ou désobligeante à l'égard de la Bible elle-même. Faites preuve de correction, tout simplement. N'altérez et ne changez pas le sens de la Bible, ni de son interprétation possible.

Si vous voulez utiliser ces contenus à des fins commerciales, vous devez solliciter une approbation spécifique auprès de nous en envoyant un courriel à support@bibles.org en précisant API dans le champ objet. De plus, nous vous demandons de ne pas afficher plus de 500 versets consécutifs à la fois, et de toujours mentionner le copyright pour les versions que vous utilisez en regard des contenus bibliques affichés. Vous pouvez également vous référer aux Termes et Conditions complets concernant l'API ici.

Quels types d'applications puis-je créer ?

Tant que vous utilisez les contenus bibliques de manière non commerciale et positive en respectant l'intégrité du texte comme précisé ci-dessus, vous avez la liberté de créer tout ce que vous voulez. Nous sommes toujours curieux de ce que les développeurs peuvent imaginer - merci donc de partager vos créations avec nous et avec la communauté sur le forum API BibleSearch.

Quelles versions sont disponibles ?

Actuellement, nous ne sommes en mesure de proposer que les versions indiquées ci-dessous. Nous voulons mettre à votre disposition autant de versions que possible, mais il nous faut d'abord obtenir l'accord des différents éditeurs. S'il y a un texte auquel vous cherchez tout particulièrement à accéder, merci de nous le faire savoir par courriel ou sur nos forums, et nous ferons de notre mieux pour vous aider !

View Available API Versions

Pourquoi n'y a-t-il pas plus de traductions de la Bible ?

Les traductions de la Bible sont la propriété intellectuelle de différents éditeurs et détenteurs de droits. Pour permettre l'accès à une version par l'intermédiaire de l'API, nous devons au préalable obtenir une permission spéciale auprès des différents éditeurs. En cas de souhait particulier, le moyen le plus rapide pour obtenir cette permission consiste à vous manifester en demandant l'accès sur notre Forum API BibleSearch. Si vous nous indiquez ce que vous voulez, nous pouvons contacter les éditeurs et faire de notre mieux pour obtenir la permission.

Pour construire une relation de confiance avec les éditeurs et les détenteurs de propriété intellectuelle, nous avons intégré dans l'API un système de gestion d'utilisation correcte. Celui-ci nous permet de fournir des informations supplémentaires sur le mode de consommation des contenus bibliques par les utilisateurs de l'API, et en fin de compte par les utilisateurs finaux de votre application. Nous nous efforçons vraiment d'insister sur la transparence concernant l'utilisation des contenus bibliques par l'intermédiaire de notre API, puisque c'est cela qui montrera aux éditeurs et aux détenteurs de propriété intellectuelle que nous protégeons leurs contenus, et que nous garantissons qu'elle préserve l'intégrité que mérite la Bible.

Qu'est-ce que le système de gestion d'utilisation correcte ?

Le système de gestion d'utlisation correcte nous permet d'identifier l'usage qui est fait des contenus bibliques par l'API. Pour vous en servir, vous intégrez une petite séquence supplémentaire de code JavaScript partout où vous affichez le résultat d'un appel API sur votre site web. L'API fournira toujours le bon JavaScript à utiliser pour l'appel que vous avez fait, si bien qu'il vous suffit de l'ajouter à votre site web.

Pourquoi exiger l'utilisation du système de gestion d'utilisation correcte ?

Le système de gestion d'utilisation correcte nous permettra de fournir aux éditeurs de Bibles des informations leur montrant l'utilisation qui est faite de leurs contenus. Cela nous aidera à ajouter à l'API davantage de traductions de la Bible en montrant le rayonnement supplémentaire que l'accès par l'API donne à une version. Et cela nous aidera à employer nos ressources de développement et nos moyens matériels de telle manière que l'API s'élargisse aux éléments et données qui sont importants pour les utilisateurs de l'API.

Quelles sont les implications du système de gestion d'utilisation correcte pour mon application ?

L'impact sur votre application du système de gestion d'utilisation correcte (FUMS) sera minimal. Nous avons optimisé le code et la fourniture du JavaScript pour que vos visiteurs ne soient pas affectés par son utilisation. Le FUMS n'utilise aucune information personnellement identifiable. De plus, au fur et à mesure que nous continuons à développer les capacités du FUMS, vous pourrez accéder à des statistiques avancées montrant comment les données API que vous affichez sur votre site sont utilisées par vos visiteurs.

Puis-je mettre des données en cache ?

Vous pouvez mettre des données en cache, mais nous vous demandons de les limiter à un maximum de 500 versets consécutifs. Nous vous recommandons également de vider votre cache au moins tous les 14 jours, voire plus souvent, parce que la structure de nos données est sans cesse mise à jour et améliorée pour les rendre plus accessibles. Il n'est donc pas conseillé de mettre en cache des données pour une longue période car nous voulons que vous disposiez des données bibliques les plus actuelles.

Combien de demandes puis-je faire par jour ? Y a-t-il un maximum à ne pas dépasser ?

Oui, il y a un maximum à ne pas dépasser. Vous ne pouvez faire plus de 5 000 requêtes par jour. Si vous créez une application importante qui nécessitera davantage de requêtes quotidiennes, veuillez prendre contact avec nous par courriel ou sur le forum afin que nous puissions vous proposer une solution correspondant à vos besoins ! En fin de compte, nous voulons vous donner accès aux contenus bibliques dont vous avez besoin tout en protégeant nos serveurs.

Puis-je solliciter l'autorisation de dépasser la limite maximale ?

C'est assurément une possibilité ! Ecrivez-nous à support@bibles.org en précisant API dans le champ objet et indiquez sur quoi vous travaillez et quel type d'accès il vous faut. Nous nous ferons un plaisir de coopérer et d'essayer de répondre à vos besoins.

Comment utiliser l'API ?

Pour démarrer avec l'API, nous vous proposons de parcourir la documentation complète pour découvrir les capacités et les limites de l'API actuelle. En cas de problème, pensez à notre Forum API BibleSearch pour solliciter l'aide de la communauté. Nous prenons connaissance du forum quotidiennement et répondons aux questions et demandes de dépannage. Si vous souhaitez une aide immédiate, faites-en la demande sur le forum, et nous reviendrons vers vous dès que possible.

Faut-il que j'indique le copyright pour chaque version que j'affiche ?

Oui. Nous sommes convaincus qu'il est important de mentionner les droits des éditeurs détenteurs du copyright sur une version de contenus bibliques donnée. Dans cette optique, merci de faire figurer la mention de copyright en regard de tout texte biblique que vous affichez.

Comment intégrer ma traduction dans l'API ?

Si vous êtes éditeur ou détenteur de propriété intellectuelle et que vous voulez que la traduction de votre Société biblique soit mise à disposition dans BibleSearch et par l'intermédiaire de l'API, nous serions heureux que vous nous contactiez. Ecrivez-nous à support@bibles.org

Que faire si ma question n'est pas abordée ici ?

Nous avons un forum où vous pouvez explorer les questions et contributions de la communauté, ainsi que des articles de notre équipe de développement. Si vous n'y trouvez pas ce que vous cherchez et que vous avez besoin d'aide immédiatement, écrivez-nous à support@bibles.org en mentionnant API dans le champ objet.