Importer des centaines de logements

Pousser mille logements un par un fonctionne, mais tient une connexion pendant des heures et vous laisse sans vue d’ensemble. Pour un premier raccordement ou une reprise de parc, envoyez-les ensemble.

Envoyer

Le corps est le même que pour un logement seul, dans un tableau properties. Cinq cents au maximum par envoi.

curl -X POST https://localoge.com/api/v1/channel/properties/bulk \
  -H "Authorization: Bearer $LOCALOGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "properties": [
      { "external_property_id": "PROP-1", "title": "Studio vue mer", "city": "Agde", "…": "…" },
      { "external_property_id": "PROP-2", "title": "Maison au calme",  "city": "Uzès", "…": "…" }
    ]
  }'

{
  "success": true,
  "data": {
    "import_id": "8ae3d395-7ccd-42e3-89c8-6c22d77ec1d7",
    "accepted": 2,
    "status_url": "/api/v1/channel/imports/8ae3d395-7ccd-42e3-89c8-6c22d77ec1d7"
  }
}

La réponse est un 202, pas un 201

Rien n’est encore créé. Nous avons accepté la charge et nous la traitons en fond : chaque logement demande un géocodage et le téléchargement de ses photos. Ne dites pas à votre hôte que ses logements sont en ligne à la seconde où vous recevez cette réponse : demandez d’abord l’avancement.

Les logements dont la charge est invalide sont refusés tout de suite, avant même l’acceptation, et comptés comme échecs avec leur motif. accepted ne compte donc que ceux qui partent en traitement. Si aucun n’est valide, vous recevez un 400 et rien n’est créé.

Suivre

curl https://localoge.com/api/v1/channel/imports/8ae3d395-… \
  -H "Authorization: Bearer $LOCALOGE_KEY"

{
  "success": true,
  "data": {
    "id": "8ae3d395-…",
    "status": "termine",
    "total": 3,
    "processed": 3,
    "succeeded": 2,
    "failed": 1,
    "errors": [
      { "external_property_id": "PROP-3", "motif": "String must contain at least 1 character(s)" }
    ],
    "started_at": "2026-08-27T00:41:02.000Z",
    "ended_at": "2026-08-27T00:41:24.000Z"
  }
}

status	Ce que ça veut dire
en_attente	Accepté, pas encore commencé, ou entre deux paquets.
en_cours	Un paquet est en cours de traitement.
termine	Tous les logements ont été traités. Lisez failed et errors.
echec	L’import n’a pas pu aboutir. Écrivez-nous avec l’import_id.

total compte les logements que vous avez envoyés, processed vaut toujours succeeded + failed. Un import terminé avec failed à zéro est un import entièrement passé.

Un logement qui échoue n’arrête pas les autres

Une adresse illisible ou une photo morte fait échouer ce logement, et lui seul. Les quatre cent quatre-vingt-dix-neuf autres passent. Vous corrigez ce qui figure dans errors et vous le renvoyez : external_property_id étant votre clé, un renvoi met à jour au lieu de dupliquer.

Combien de temps

Nous traitons par paquets de dix, en fond. Comptez de une à trois secondes par logement selon le nombre de photos. Cinq cents logements demandent donc de dix à vingt-cinq minutes. Interrogez l’avancement toutes les trente secondes, pas toutes les secondes : ce point d’entrée compte dans vos limites de débit.

Ce que l’import ne fait pas

Il crée et met à jour les fiches. Il ne pousse ni les disponibilités ni les tarifs : envoyez-les ensuite, logement par logement ou par lot, avec Disponibilités et Tarifs.

Et il ne publie rien. Un logement importé arrive en brouillon : il lui manque au minimum trois photos, et son hôte doit avoir un compte de paiement en état de recevoir l’argent. Voir Qui touche l’argent.