50 lines
1.4 KiB
Plaintext
50 lines
1.4 KiB
Plaintext
<page xmlns="http://projectmallard.org/1.0/"
|
||
type="topic" id="api-intro" xml:lang="fr">
|
||
|
||
<info>
|
||
<link type="guide" xref="index#api" group="#first" />
|
||
<revision docversion="0.1" date="2013-01-04" status="draft"/>
|
||
<credit type="author">
|
||
<name>Frédéric Péters</name>
|
||
<email>fpeters@entrouvert.com</email>
|
||
</credit>
|
||
<desc>Public cible, principes généraux, etc.</desc>
|
||
|
||
</info>
|
||
|
||
<title>Introduction aux API</title>
|
||
|
||
<p>
|
||
Cette section de la documentation s’adresse aux développeurs
|
||
d’applications tierces désirant interfacer celles-ci avec w.c.s.
|
||
</p>
|
||
|
||
<section id="tech">
|
||
<title>Aspects techniques</title>
|
||
|
||
<p>
|
||
L’API Web Services est constituée d’appels REST, qui sont idéalement effectués
|
||
en HTTPS, pour assurer la sécurité et la confidentialité des échanges. Le
|
||
format d’échange des données est JSON. Ces deux propriétés la rendent
|
||
accessible facilement à tous les langages et environnements de programmation
|
||
modernes.
|
||
</p>
|
||
|
||
<p>
|
||
Cette documentation se veut facile à lire, avec beaucoup de notes et
|
||
d’exemples. Les différentes pages détaillent les points d’accès à
|
||
utiliser pour réaliser les différentes opérations.
|
||
</p>
|
||
|
||
<note>
|
||
<p>
|
||
Les exemples donnés dans ce document utilisent pour la plupart l’outil en
|
||
ligne de commande <app>curl</app> qui permet de manière simple l’envoi de
|
||
requêtes HTTP à un serveur.
|
||
</p>
|
||
</note>
|
||
|
||
</section>
|
||
|
||
</page>
|