Déclarer l’historique d’un programme

POST /irrigation/schedules/{scheduleId}/backfill

Scope irrigation:write
Clé API x-api-key
URL de base https://api.hub.akuasense.com/v1

Développe les occurrences PASSÉES du programme et les marque réalisées et vérifiées. Geste EXPLICITE : la création d’un programme ne remonte jamais le temps toute seule. Plafond 3 ans, et jamais avant startsOn.

Paramètres de chemin

scheduleId integer obligatoire

En-têtes

Idempotency-Key string

Rejoue la même réponse 2xx (24 h)

Corps de la requête

from string date

Défaut : startsOn du programme. Relevé au startsOn si antérieur.
to string date

Défaut : aujourd’hui.

Réponse

200

Bilan de la déclaration

scheduleId integer
modules integer

Sondes touchées (un programme de parcelle en vise plusieurs).
occurrences integer

Occurrences développées sur la période.
inserted integer

Occurrences réellement écrites. Inférieur à occurrences quand certaines existaient déjà : le geste est rejouable sans produire de doublon, et ne réécrit jamais ce que le client a déjà déclaré.
horizonDay string date
fromDay string date

Borne basse effectivement retenue — jamais avant startsOn du programme.
toDay string date
truncated boolean

true = la période demandée a été ramenée au plafond de 3 ans.

Erreurs

400
Corps invalide
401
Non authentifié
403
Scope/rôle insuffisant ou hors société
404
Programme introuvable

SCHEDULE_NOT_FOUND

POST /irrigation/schedules/{scheduleId}/backfill

curl -X POST https://api.hub.akuasense.com/v1/irrigation/schedules/17/backfill \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "2026-06-01",
    "to": "2026-08-31"
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/irrigation/schedules/17/backfill',
  {
    method: 'POST',
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "from": "2026-06-01",
      "to": "2026-08-31"
    }),
  },
);
const data = await response.json();

import requests

response = requests.post(
    "https://api.hub.akuasense.com/v1/irrigation/schedules/17/backfill",
    headers={"x-api-key": "VOTRE_CLE_API"},
    json={
        "from": "2026-06-01",
        "to": "2026-08-31",
    },
)
data = response.json()

Réponse

{
  "scheduleId": 17,
  "modules": 1,
  "occurrences": 39,
  "inserted": 39,
  "horizonDay": "2026-08-31",
  "fromDay": "2026-06-01",
  "toDay": "2026-08-31",
  "truncated": false
}

application/json

{
  "type": "string",
  "title": "string",
  "status": 400,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 401,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 403,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 404,
  "detail": "string",
  "code": "SCHEDULE_NOT_FOUND"
}

application/problem+json · exemple généré depuis le schéma