Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"lines"
],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"product",
"quantity"
],
"properties": {
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"encoding": {
"$ref": "#/properties/lines/items/properties/encoding",
"description": "Contenu de la puce NFC. Seulement pour une carte à puce NTAG (voir `encodable` de list_products)."
},
"back_upload_id": {
"$ref": "#/properties/lines/items/properties/front_upload_id"
},
"front_upload_id": {
"$ref": "#/properties/lines/items/properties/front_upload_id"
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 2,
"description": "Un visuel (et un contenu de puce) PAR CARTE, pour une équipe : autant d'entrées que `quantity`, au moins deux. Le tarif dégressif s'applique sur la quantité totale. Ne se combine pas avec front_upload_id, back_upload_id, encoding, encodings."
},
"product": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Le slug rendu par list_products. Jamais de mémoire."
},
"encoding": {
"type": "object",
"required": [
"type"
],
"properties": {
"lock": {
"type": "boolean",
"description": "true (défaut, comme sur le Studio) : la puce est verrouillée en lecture seule après l'écriture, IRRÉVERSIBLE ; le panier l'indique (« verrouillé »). false : seulement si la personne veut pouvoir la réécrire. Préviens-la que la puce sera verrouillée sauf demande contraire."
},
"type": {
"enum": [
"uri",
"text",
"empty"
],
"type": "string",
"description": "'uri' : une adresse (dans `content`), 'text' : un texte, 'empty' : puce non encodée."
},
"content": {
"type": "string",
"maxLength": 1000,
"description": "L'adresse complète (https://…) ou le texte. Jamais inventé : donné par la personne."
}
},
"description": "Un même contenu de puce pour toutes les cartes.",
"additionalProperties": false
},
"quantity": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Nombre de cartes de cette ligne. Au moins `min_quantity` du produit."
},
"encodings": {
"type": "array",
"items": {
"$ref": "#/properties/lines/items/properties/encoding"
},
"maxItems": 10000,
"description": "Un contenu de puce par carte, même visuel : au plus `quantity` entrées, dans l'ordre. Ne se combine pas avec `encoding`."
},
"blank_back": {
"type": "boolean",
"description": "true : verso vierge (aucun fichier verso)."
},
"back_upload_id": {
"$ref": "#/properties/lines/items/properties/front_upload_id",
"description": "Visuel du verso. Sans lui ni blank_back, la personne l'enverra elle-même."
},
"front_upload_id": {
"type": "string",
"format": "uuid",
"description": "Visuel du recto, rendu par create_upload ou upload_file. Le même pour toutes les cartes de la ligne."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
},
"locale": {
"enum": [
"fr",
"en",
"de",
"it",
"es"
],
"type": "string",
"description": "Langue de la personne : noms des produits, et page du Studio où elle arrivera. Celle de la conversation."
}
},
"additionalProperties": false
}