ForHosting KIT · Notifications et automatisations

Tâches programmées

Cette capacité fait tourner une tâche à intervalle régulier : tous les matins, chaque lundi, le premier de chaque mois. Vous décrivez l’opération et le rythme ; le KIT la déclenche à l’heure dite, jusqu’à ce que vous l’arrêtiez. Elle sert pour tout ce qui doit se répéter sans qu’on l’oublie.

● Stablepar requête + par exécution$0.002

Voir l’API — $0.002 Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Ce qui doit revenir, revient tout seul

Certaines tâches ne sont pas difficiles, seulement régulières : envoyer un récapitulatif chaque matin, vérifier un site chaque heure, produire un rapport chaque fin de mois. Le problème n’est pas de les faire, c’est de ne jamais les oublier. En les programmant, vous confiez le rythme au KIT : la tâche se relance d’elle-même à l’échéance prévue, que vous soyez là ou non. Vous passez d’un rappel mental fragile à un automatisme fiable, et vous libérez votre attention pour ce qui la mérite vraiment.

Fixer le bon rythme

Vous choisissez la cadence qui convient : toutes les heures pour une surveillance serrée, une fois par jour pour un récapitulatif, une fois par semaine ou par mois pour un bilan. L’heure et le fuseau sont réglés à votre main, de sorte qu’une tâche « du lundi 8 h » tombe bien le lundi à huit heures en France. Chaque déclenchement est daté, ce qui laisse une trace de ce qui a tourné et quand. Vous pouvez suspendre, modifier ou reprendre la programmation à tout moment, sans repartir de zéro.

Programmer quoi, et depuis où

La tâche répétée peut être une capacité simple ou un enchaînement complet : lire, transformer, notifier, le tout relancé à heure fixe. La programmation se met en place depuis cette page ou via l’API, et s’appuie sur un planificateur autonome qui n’exige aucune machine allumée chez vous. En la reliant à la relance automatique, une exécution ratée peut être retentée sans attendre le prochain cycle. L’e-mail et Telegram comptent parmi les canaux du KIT en cours d’ouverture pour recevoir le résultat.

Cas d’usage

Envoyer un récapitulatif chaque matin

Atelier Garnier SARL programme, chaque jour à 7 h, la production et l’envoi d’un résumé des commandes de la veille, prêt à lire au démarrage de la journée.

Vérifier un site à intervalle régulier

Studio Lumen SAS fait contrôler l’état d’un site client toutes les heures, la vérification se relançant seule sans surveillance humaine.

Générer un rapport mensuel

Le 1er de chaque mois, Menuiserie Rousseau & Fils déclenche automatiquement la compilation de son bilan d’activité, sans avoir à y penser.

Questions fréquentes

Quels rythmes de répétition sont possibles ?

Des cadences courantes — toutes les heures, chaque jour, chaque semaine, chaque mois — ou un horaire précis que vous fixez. Vous choisissez le moment exact et le fuseau, pour que la tâche tombe pile quand elle doit tomber.

La tâche tourne-t-elle même si mon ordinateur est éteint ?

Oui. La programmation repose sur un planificateur côté serveur, indépendant de vos appareils. Une fois la tâche réglée, elle se déclenche à l’heure prévue sans qu’aucune machine ne reste allumée chez vous.

Que se passe-t-il si une exécution programmée échoue ?

Elle est signalée, et les exécutions suivantes ont lieu normalement à leur tour. En reliant la programmation à la relance automatique, un échec peut être retenté aussitôt, sans devoir attendre le cycle d’après.

Comment le prix d’une tâche récurrente se calcule-t-il ?

Chaque exécution coûte $0.002, en dollars US, à quoi s’ajoute le prix de l’opération réellement effectuée. Une tâche quotidienne sur un mois revient donc à une trentaine d’exécutions, dont le coût se calcule d’avance, sans abonnement.

Puis-je suspendre ou arrêter une programmation ?

Oui, à tout moment. Vous pouvez mettre la tâche en pause, en changer le rythme ou l’arrêter définitivement. Tant qu’elle est suspendue, aucune exécution n’a lieu et rien n’est facturé à ce titre.

En quoi est-ce différent d’un e-mail programmé ?

L’e-mail programmé part une fois, à une date donnée. La tâche programmée se répète selon un rythme, indéfiniment, et peut déclencher n’importe quelle opération, pas seulement un envoi de message.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/flow/schedule

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/flow/schedule \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/flow/schedule", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/schedule",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/schedule", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/schedule", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "input": "…"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "flow.schedule",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →