fixou

Liste tous les metiers proposes par Fixou, regroupes par famille, avec le questionnaire propre a chaque metier. A appeler avant create_request : le `slug` d'un metier devient le `categorySlug`, et le questionnaire indique les questions a couvrir. Dans create_request, l'objet `answers` doit utiliser les `id` de question comme cles et, comme valeurs, les `value` des options proposees (jamais les libelles).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cree une demande de devis Fixou au nom du client final. IMPORTANT : la demande n'est PAS publiee immediatement — elle attend une confirmation par email (double opt-in). L'email est celui du CLIENT FINAL (pas de l'agent) et est obligatoire : le client recevra un email « Confirmez votre demande » avec un lien valable 48 heures ; tant qu'il n'a pas clique, aucun artisan n'est contacte. Apres cet appel, invitez explicitement l'utilisateur a ouvrir sa boite mail et a cliquer sur ce lien de confirmation pour publier sa demande et suivre les reponses sur fixou.fr ; l'agent lui-meme n'a jamais acces a cet espace. La description doit faire au moins 20 caracteres. `answers` reprend les `id` de questions et les `value` d'options du metier (voir list_categories). Renvoie le `requestId` a utiliser avec get_request.

{
  "type": "object",
  "properties": {
    "categorySlug": {
      "type": "string",
      "description": "Slug du metier concerne, obtenu via list_categories."
    },
    "answers": {
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      },
      "description": "Reponses au questionnaire du metier, indexees par `id` de question. Valeur unique (question single) ou tableau de valeurs (question multi), choisies parmi les `value` des options."
    },
    "description": {
      "type": "string",
      "minLength": 20,
      "maxLength": 5000,
      "description": "Description libre du besoin, en francais, de 20 a 5000 caracteres."
    },
    "postalCode": {
      "type": "string",
      "description": "Code postal francais du lieu d'intervention (5 chiffres)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Email du client final (obligatoire) ; il y recevra le lien de confirmation a cliquer pour publier sa demande, puis le suivi."
    },
    "phone": {
      "type": "string",
      "description": "Telephone du client final (optionnel), transmis aux artisans qu'il choisira."
    }
  },
  "required": [
    "categorySlug",
    "answers",
    "description",
    "postalCode",
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Consulte le statut d'une demande Fixou et les reponses des artisans (nom de l'entreprise, message, prix indicatif, delai, note moyenne). Ne renvoie jamais de coordonnees : celles-ci ne sont communiquees qu'au client final, une fois qu'il a choisi un artisan sur fixou.fr. Une cle API ne peut consulter que les demandes qu'elle a elle-meme creees.

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Identifiant de la demande, renvoye par create_request."
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}