<?xml
version="1.0" encoding="utf-8"?>
<rss version="2.0" 
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:atom="http://www.w3.org/2005/Atom"
>

<channel xml:lang="fr">
	<title>zQR-Codes</title>
	<link>https://qrc.dnc.global/</link>
	
	<language>fr</language>
	<generator>SPIP - www.spip.net</generator>
	<atom:link href="https://qrc.dnc.global/spip.php?page=backend" rel="self" type="application/rss+xml" />




<item xml:lang="fr">
		<title>API HTTP Rest</title>
		<link>https://qrc.dnc.global/API-HTTP-Rest</link>
		<guid isPermaLink="true">https://qrc.dnc.global/API-HTTP-Rest</guid>
		<dc:date>2020-11-03T14:48:04Z</dc:date>
		<dc:format>text/html</dc:format>
		<dc:language>fr</dc:language>
		<dc:creator>B. Degoy</dc:creator>



		<description>
&lt;p&gt;zQR-Codes expose une API HTTP Rest. &lt;br class='autobr' /&gt; Acc&#233;der &#224; l'API &lt;br class='autobr' /&gt;
L'acc&#232;s &#224; l'API est limit&#233; au cadre d'un abonnement donn&#233;. L'abonnement doit &#234;tre valide. &lt;br class='autobr' /&gt;
L'acc&#232;s &#224; l'API n&#233;cessite donc de fournir dans la requ&#234;te les identifiants de l'utilisateur (login et password utilis&#233;s pour la connexion &#224; l'application zQR-Codes avec i-Tego SaaS). &lt;br class='autobr' /&gt;
Exemple : https://login:password@qrc.dnc.global/api/json/qrcodes &lt;br class='autobr' /&gt;
Op&#233;rations permises par l'API &lt;br class='autobr' /&gt;
L'API permet &#224; un utilisateur d'effectuer les op&#233;rations CRUD (&#8230;)&lt;/p&gt;


-
&lt;a href="https://qrc.dnc.global/-Documentation-" rel="directory"&gt;Documentation&lt;/a&gt;


		</description>


 <content:encoded>&lt;div class='rss_chapo'&gt;&lt;p&gt;zQR-Codes expose une API HTTP Rest.&lt;/p&gt;&lt;/div&gt;
		&lt;div class='rss_texte'&gt;&lt;h2 class=&#034;spip&#034;&gt;Acc&#233;der &#224; l'API&lt;/h2&gt;
&lt;p&gt;L'acc&#232;s &#224; l'API est limit&#233; au cadre d'un abonnement donn&#233;. L'abonnement doit &#234;tre valide.&lt;/p&gt;
&lt;p&gt;L'acc&#232;s &#224; l'API n&#233;cessite donc de fournir dans la requ&#234;te les identifiants de l'utilisateur (login et password utilis&#233;s pour la connexion &#224; l'application zQR-Codes avec i-Tego SaaS).&lt;/p&gt;
&lt;p&gt;Exemple :&lt;/p&gt;
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;https://login:password@qrc.dnc.global/api/json/qrcodes&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 class=&#034;spip&#034;&gt;Op&#233;rations permises par l'API&lt;/h2&gt;
&lt;p&gt;L'API permet &#224; un utilisateur d'effectuer les op&#233;rations CRUD sur la table des QR-Codes en fonction de la m&#233;thode de la requ&#234;te HTTP GET, POST, PUT ou DELETE :&lt;/p&gt;
&lt;h2 class=&#034;spip&#034;&gt;Formats&lt;/h2&gt;
&lt;p&gt;Dans l'&#233;tat actuel du d&#233;veloppement, l'API de O-DGuide n'expose que le format suivant :&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Format json&lt;/strong&gt;&lt;br class='autobr' /&gt;
Retourne un simple array. Exemple : la requ&#234;te :&lt;/p&gt;
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;https://qrc.dnc.global/api/json/qrcode/1&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;retourne :&lt;/p&gt;
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='javascript spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 class=&#034;spip&#034;&gt;Types&lt;/h2&gt;
&lt;p&gt;Dans l'&#233;tat actuel du d&#233;veloppement, l'API de O-DGuide n'expose que le type 'qrcode'.&lt;/p&gt;
&lt;h2 class=&#034;spip&#034;&gt;Actions&lt;/h2&gt;
&lt;p&gt;Suivant le paradigme HTTP Rest, les actions d&#233;coulent de la m&#233;thode HTTP utilis&#233;e pour appeler l'API : get, post, put ou delete.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Formes g&#233;n&#233;rales des requ&#234;tes&lt;/strong&gt;&lt;br class='autobr' /&gt; Une requ&#234;te GET prend la forme :&lt;br class='autobr' /&gt;
&lt;code class='spip_code spip_code_inline' dir='ltr'&gt;https://qrc.dnc.global/api/[path_parameters] | [?request_parameters]&lt;/code&gt;&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; path_parameters : &lt;format&gt;/&lt;type&gt;[/ressource] &lt;br class='autobr' /&gt;
g&#233;n&#233;ralement ce sera : json/qrcode, NN indiquant l'ID d'un QR-Code pr&#233;cis.&lt;/li&gt;&lt;/ul&gt;&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; query_parameters : dans le cas de GET, il s'agit des classiques param&#232;tres d'URL, tels que &#034;url_cible=https://mon_site.com/blabla.php&#034;.&lt;/li&gt;&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Exemple de requ&#234;tes GET&lt;/strong&gt;&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; Afficher la liste des QR-Codes disponibles pour l'auteur authentifi&#233; :
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;https://qrc.dnc.global/api/json/qrcode&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&lt;/ul&gt;&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; Acc&#232;s &#224; une ressource pr&#233;cise :
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;https://qrc.dnc.global/api/json/qrcode/33&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;o&#249; 33 est l'ID de ressource, en l'occurrence la valeur du champ id_qrcode de l'enregistrement dans la table.&lt;/p&gt;
&lt;/li&gt;&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Requ&#234;tes avec POST, PUT et DELETE&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Ces requ&#234;tes doivent &#234;tre g&#233;n&#233;r&#233;es programmatiquement : par exemple avec cURL c&#244;t&#233; serveur ou en Javascript c&#244;t&#233; client. On trouve couramment des biblioth&#232;que exposant des fonctions de ce type :&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; post_collection($requete, $reponse)&lt;br class='autobr' /&gt;
Cr&#233;er une nouvelle ressource dans la collection (cr&#233;er un nouvel enregistrement dans la table).&lt;/li&gt;&lt;/ul&gt;&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; put_ressource($requete, $reponse)&lt;br class='autobr' /&gt;
Ce cas est sensiblement le m&#234;me que le pr&#233;c&#233;dent, &#224; ceci pr&#232;s que l'on travaille sur la modification d'une ressource pr&#233;cise.&lt;/li&gt;&lt;/ul&gt;&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; delete_ressource($requete, $reponse)&lt;br class='autobr' /&gt;
Supprimer d&#233;finitivement une ressource.&lt;/li&gt;&lt;/ul&gt;
&lt;p&gt;Pour la transmission des donn&#233;es aux requ&#234;tes avec POST et PUT, on applique le format application/json. Dans l'exemple qui suit, on passe deux tableaux PHP, la fonction se chargeant de l'encodage JSON et de la d&#233;claration. On passe les param&#232;tres de la fa&#231;on suivante :&lt;/p&gt;
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;$path_parameters = &#034;json/qrcode&#034;; $query_parameters = array( 'id_auteur' =&gt; '1', // SPIP administrator 'titre' =&gt; $titre, 'url_cible' =&gt; $url_cible, 'statut' =&gt; 'publie' ); &lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;et voici la fonction :&lt;/p&gt;
&lt;div class=&#034;precode&#034;&gt;&lt;pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'&gt;&lt;code&gt;function http_request( $apiurl, $method, $path_parameters=null, $query_parameters=null ) { $url = $apiurl . $path_parameters; $h = curl_init($url); if ( !empty($query_parameters) ) curl_setopt($h, CURLOPT_POSTFIELDS, json_encode($query_parameters)); if ( $method == &#034;POST&#034; ) { $header[] = &#034;content-type: application/json&#034;; } else if ( $method !== &#034;GET&#034; ) { curl_setopt($h, CURLOPT_CUSTOMREQUEST, $method); } curl_setopt($h, CURLOPT_FOLLOWLOCATION, true); curl_setopt($h, CURLOPT_RETURNTRANSFER, true); curl_setopt($h, CURLOPT_TIMEOUT, 10); curl_setopt($h, CURLOPT_HTTPHEADER, $header); $result = curl_exec($h); curl_close($h); return $result; }&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
		
		</content:encoded>


		

	</item>
<item xml:lang="fr">
		<title>Pr&#233;sentation de zQR-Codes</title>
		<link>https://qrc.dnc.global/Presentation-de-iQR-Codes</link>
		<guid isPermaLink="true">https://qrc.dnc.global/Presentation-de-iQR-Codes</guid>
		<dc:date>2020-10-15T13:56:15Z</dc:date>
		<dc:format>text/html</dc:format>
		<dc:language>fr</dc:language>
		



		<description>&lt;p&gt;Avec zQR-Codes cr&#233;ez vos propres matrices et modifiez &#224; volont&#233; la page ( l'URL ) cible.&lt;/p&gt;
&lt;p&gt;Les QR codes g&#233;n&#233;r&#233;s de fa&#231;on classique&lt;/p&gt;
&lt;p&gt;Diff&#233;rents outils disponibles sur le Web permettent de cr&#233;er un QR-code traduisant directement l'URL de la page &#224; visiter. Une telle fa&#231;on de faire, liant d&#233;finitivement le QR code &#224; une page et une seule, pr&#233;sente des inconv&#233;nients majeurs, par exemple dans les situations suivantes : Vous avez compos&#233; une carte professionnelle ou une plaquette publicitaire avec un QR code branchant sur (...)&lt;/p&gt;

-
&lt;a href="https://qrc.dnc.global/-Documentation-" rel="directory"&gt;Documentation&lt;/a&gt;


		</description>


 <content:encoded>&lt;div class='rss_chapo'&gt;&lt;p&gt;Avec zQR-Codes cr&#233;ez vos propres matrices QR et modifiez &#224; volont&#233; la page cible.&lt;/p&gt;&lt;/div&gt;
		&lt;div class='rss_texte'&gt;&lt;h2 class=&#034;spip&#034;&gt;Les QR codes g&#233;n&#233;r&#233;s de fa&#231;on classique&lt;/h2&gt;
&lt;p&gt;Diff&#233;rents outils disponibles sur le Web permettent de cr&#233;er un QR-code traduisant directement l'URL de la page &#224; visiter. Une telle fa&#231;on de faire, liant d&#233;finitivement le QR code &#224; une page et une seule, pr&#233;sente des inconv&#233;nients majeurs, par exemple dans les situations suivantes :&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; Vous avez compos&#233; une carte professionnelle ou une plaquette publicitaire avec un QR code branchant sur la page d'accueil de votre site Internet. Que faites-vous si vous changez le nom de domaine de votre site ? Si, participant &#224; une exposition, vous voulez faire la promotion de votre stand ? Si, lan&#231;ant un nouveau produit vous voulez brancher directement vos visiteurs sur la page de ce produit ?&lt;/li&gt;&lt;/ul&gt;&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; Vous avez publi&#233; &#224; grand frais un catalogue de vos produits. Vous avez plac&#233; dans diff&#233;rentes pages des QR codes permettant &#224; vos clients de se connecter sur votre site Internet pour en savoir plus. Vos produits &#233;voluent, un nouveau produit arrive : continuerez-vous de connecter vos clients sur l'ancien produit et les laisserez-vous dans l'ignorance du nouveau produit ?&lt;/li&gt;&lt;/ul&gt;&lt;h2 class=&#034;spip&#034;&gt;Les QR codes index&#233;s&lt;/h2&gt;
&lt;p&gt;DnC propose sa technique d'indexation des QR-codes. Dans ce contexte, les donn&#233;es d'un QR-code sont r&#233;duites au nom de domaine du site support et &#224; un index, par exemple :&lt;/p&gt;
&lt;p&gt;&lt;a href=&#034;https://qrc.dnc.global/3&#034; class=&#034;spip_url auto&#034; rel=&#034;nofollow&#034;&gt;https://qrc.dnc.global/3&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Le site support re&#231;oit cette URL et la traduit &#224; l'aide d'une base de donn&#233;es comportant, &#224; la valeur de l'index, une &lt;strong&gt;URL cible&lt;/strong&gt;. Le visiteur qui flashe le QR-Code est imm&#233;diatement redirig&#233; vers cette URL (s'il s'agit d'une page Web, mais ce peut &#234;tre la commande d'un objet connect&#233;, etc.).&lt;/p&gt;
&lt;p&gt;Le site support fournit tous les outils n&#233;cessaires pour g&#233;rer cette URL, en particulier pour en modifier l'adresse &#224; tout moment.&lt;/p&gt;
&lt;p&gt;De plus, la base de donn&#233;es du site support contient les entr&#233;es suivantes pour chaque code :&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; un titre,&lt;/li&gt;&lt;li&gt; une description,&lt;/li&gt;&lt;li&gt; des statistiques de l'utilisation de chaque QR-Code.&lt;/li&gt;&lt;/ul&gt;
&lt;p&gt;permettant des usages avanc&#233;s tels que :&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; affichage d'un message particulier ;&lt;/li&gt;&lt;li&gt; affichage de plusieurs bandeaux offrant au visiteur le choix de la page cible ;&lt;/li&gt;&lt;li&gt; publicit&#233; pr&#233;alable &#224; la redirection sous forme de banni&#232;re ou de vid&#233;o ;&lt;/li&gt;&lt;li&gt; affichage d'un questionnaire,&lt;/li&gt;&lt;li&gt; audio-guide,&lt;/li&gt;&lt;li&gt; etc.&lt;/li&gt;&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Notes :&lt;/strong&gt;&lt;/p&gt;
&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; Utilisez les QR codes dans le respect de la r&#233;glementation et des bons usages !&lt;/li&gt;&lt;/ul&gt;&lt;ul class=&#034;spip&#034; role=&#034;list&#034;&gt;&lt;li&gt; Un autre avantage des QR codes index&#233;s est leur moindre densit&#233; (l'URL est plus courte), permettant une lecture de plus loin qu'un QR code classique de m&#234;me dimension.&lt;/li&gt;&lt;/ul&gt;&lt;/div&gt;
		
		</content:encoded>


		

	</item>



</channel>

</rss>
