Utilisation

L'espace de test (sandbox) vous permet d'envoyer à l'endpoint BibleGet query.bibleget.io les mêmes requêtes qu'une application enverrait. Les résultats que vous voyez sont ceux que recevrait l'application, et non ceux que verrait l'utilisateur final. Vous obtiendrez donc du JSON, XML ou HTML brut, sans mise en forme. Pour voir un exemple de mise en forme telle que l'utilisateur final pourrait la voir (cela dépend toutefois de la façon dont l'application traite les données brutes et les formate pour l'utilisateur), choisissez la sortie « HTML » puis cochez « voir un exemple de mise en forme ».

Veuillez noter que cette page sandbox utilise les transient de WordPress comme mécanisme de mise en cache. Pour le moment, le projet BibleGet n'exige pas que les développeurs utilisent une clé d'accès pour utiliser le service. Cependant, ne soyez pas aveugle dans la façon dont vous utilisez le service. Si, par exemple, vous implémentez des appels vers le point de terminaison à partir d'une page Web, veuillez utiliser un mécanisme de mise en cache côté serveur ou même le stockage du navigateur côté client pour éviter de faire les mêmes appels encore et encore, enlisant le serveur. En fait, vous ne réalisez peut-être pas que sur une page Web, non seulement vous, mais tout autre internaute ou peut-être même un robot d'indexation à partir d'un outil d'indexation de recherche tel que Google, pourrait accéder à la page que vous avez créée, déclenchant une nouvelle demande au point de terminaison BibleGet. Pour cette raison, les mises à jour les plus récentes du moteur BibleGet feront quelques vérifications pour voir si trop de demandes proviennent de la même source, et si c'est le cas, commenceront à afficher un avis ou peut-être même refuser le service pour la demande.