help: add card submit API (#49520)
This commit is contained in:
parent
113089e4b8
commit
794e99bf27
|
@ -12,13 +12,104 @@
|
||||||
|
|
||||||
</info>
|
</info>
|
||||||
|
|
||||||
<title>Récupération des données de fiches</title>
|
<title>Gestion des fiches</title>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Une application tierce peut récupérer les données des fiches, peut également
|
Une application tierce peut créer des fiches, récupérer les données des fiches,
|
||||||
obtenir la liste des modèles de fiche et les schémas de données associés.
|
et peut également obtenir la liste des modèles de fiche et les schémas de
|
||||||
|
données associés.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
<section id="create">
|
||||||
|
<title>Création d'une fiche</title>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
La création d'une fiche se fait par une requête <code>POST</code> à
|
||||||
|
l’adresse <code>/api/cards/<var>slug</var>/submit</code>, le contenu de
|
||||||
|
la requête doit être un dictionnaire contenant obligatoirement un attribut
|
||||||
|
<code>data</code>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
L’attribut <code>data</code> est obligatoire et contient un dictionnaire
|
||||||
|
dont les clés sont les noms de variable (remplacé ici par
|
||||||
|
<var>varname</var>) des champs de la fiche et les valeurs le contenu de
|
||||||
|
ces champs.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<list>
|
||||||
|
<item>
|
||||||
|
<p>
|
||||||
|
Les champs de type simple tels que « Texte », « Texte long » ou
|
||||||
|
« Courriel » sont des chaînes de caractères.
|
||||||
|
</p>
|
||||||
|
</item>
|
||||||
|
|
||||||
|
<item>
|
||||||
|
<p>
|
||||||
|
Les champs de type « Liste » et « Liste à choix multiples » acceptent
|
||||||
|
différentes valeurs selon leur configuration, ceci est décrit dans
|
||||||
|
<link xref="api-fill#fill-list"/>.
|
||||||
|
</p>
|
||||||
|
</item>
|
||||||
|
|
||||||
|
<item>
|
||||||
|
<p>
|
||||||
|
Les champs de type « Date » sont des chaînes de caractères au format
|
||||||
|
ISO-8601, i.e. <code>YYYY-MM-DD</code>.
|
||||||
|
</p>
|
||||||
|
</item>
|
||||||
|
|
||||||
|
<item>
|
||||||
|
<p>
|
||||||
|
Les champs de type « Fichier » sont des dictionnaires contenant les clés
|
||||||
|
<code>filename</code> pour le nom de fichier et <code>content</code> pour le
|
||||||
|
contenu de celui-ci, encodé en base64.
|
||||||
|
</p>
|
||||||
|
</item>
|
||||||
|
|
||||||
|
<item>
|
||||||
|
<p>
|
||||||
|
Les champs de type « Carte » sont des dictionnaires contenant les clés
|
||||||
|
<code>lat</code> pour la latitute en nombre décimal et <code>lon</code>
|
||||||
|
pour la longitude en nombre décimal.
|
||||||
|
</p>
|
||||||
|
</item>
|
||||||
|
</list>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
L’exemple suivant crée une fiche « Parking », dont le modèle
|
||||||
|
de fiche a comme identifiant « parkings », qui demanderait trois champs :
|
||||||
|
adresse (nom de variable <code>adresse</code>), date d'ouverture
|
||||||
|
(nom de variable <code>date_ouverture</code>) et nom (nom de variable
|
||||||
|
<code>nom</code>).
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<screen>
|
||||||
|
<output style="prompt">$ </output><input>curl -H "Content-type: application/json" \
|
||||||
|
-H "Accept: application/json" \
|
||||||
|
-d@donnees.json \
|
||||||
|
https://www.example.net/api/cards/parkings/submit<var>?signature…</var></input>
|
||||||
|
<output>{"err": 0, "data": {"id": "5"}}</output>
|
||||||
|
</screen>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Le fichier de données utilisé (<file>donnees.json</file>) contient le
|
||||||
|
dictionnaire JSON suivant :
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<code mime="application/json">
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"adresse": "rue de l’Opéra",
|
||||||
|
"date_ouverture": "2020-11-12",
|
||||||
|
"nom": "Parking Opéra-Tolozan"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</code>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
<section id="card">
|
<section id="card">
|
||||||
<title>Récupération des données d’une fiches</title>
|
<title>Récupération des données d’une fiches</title>
|
||||||
|
|
||||||
|
@ -64,8 +155,7 @@ Le contenu ainsi obtenu est le suivant :
|
||||||
</code>
|
</code>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
La structure du contenu correspond à celle de l’API d
|
La structure du contenu correspond à celle de l’API de <link xref="#create"/>.
|
||||||
<link xref="api-get#pull">récupération des données d’un formulaire</link>.
|
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
Loading…
Reference in New Issue