Passer au contenu
AchaduDevelopers
API opérationnelleAller sur le site Web ↗
Tableau de bord →
Developers/API/monitor_create
Moniteurs

Créer un radar

Créez une recherche récurrente avec des critères commerciaux.

POST/monitorsmonitors:write
COMPORTEMENT

Le changement est validé et conservé dans le compte clé avant de répondre. Interrogez la ressource renvoyée comme source de vérité.

EFFET

Il peut modifier la ressource et émettre l'événement de domaine correspondant.

RÉPÉTITION

En cas de panne du réseau, confirmez l'état de la ressource avant de réessayer. Refaites automatiquement uniquement 429 et 5xx avec recul et gigue.

Demande

namestring · bodyNom de la règle.obligatoire
querystring · bodyMots surveillés.obligatoire
sourcestring · bodySource ou marché.facultatif
segment_idstring · bodySegment cible.facultatif
min_pricenumber · bodyPrix minimum.facultatif
max_pricenumber · bodyPrix maximum.facultatif
min_commissionnumber · bodyCommission minimale.facultatif
min_discountnumber · bodyRemise minimale.facultatif
orderstring · bodyOrdre des résultats.facultatif
limitinteger · bodyMaximum par tour.min 1 · max 100facultatif
interval_minutesinteger · bodyIntervalle entre les recherches.min 15 · max 10080facultatif
auto_approveboolean · bodyApprouve automatiquement les résultats.facultatif
activeboolean · bodyActive la surveillance.facultatif
AuthorizationBearer ach_live_...
Acceptapplication/json
Portéemonitors:write

Exemple d'exécutable

curl
curl -X POST 'https://achadu.com/api/v1/monitors' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "My integration",
  "query": "string",
  "source": "string",
  "segment_id": "string",
  "min_price": 329.9
}'

Réponse et erreurs

Chaque réponse inclut request_id. Les listes ajoutent une pagination ; les ressources mutables renvoient l'état persistant après l'opération.

201 application/json
{
  "data": {
    "id": "mon_01J...",
    "name": "Air fryers under 350",
    "source": "amazon",
    "keywords": "air fryer",
    "maximum_price": 350,
    "active": 1
  },
  "created": true,
  "request_id": "req_01J..."
}
201Ressource créée et conservée.
400Paramètre, corps ou transition non valide.
401Clé manquante, invalide, expirée ou révoquée.
402Le plan de compte ne libère pas cette interface.
403A chave precisa do escopo monitors:write.
404La fonctionnalité n'existe pas dans ce compte.
409L'état actuel empêche cette opération.
413Le corps JSON dépasse 128 Ko.
429La fenêtre de 120 requêtes par minute a été dépassée.