Monitora
Aggiorna il radar
Criteri di aggiornamento, frequenza e automazione.
PATCH
/monitors/{id}monitors:writeCOMPORTAMENTO
La modifica viene convalidata e mantenuta nell'account chiave prima di rispondere. Interroga la risorsa restituita come fonte di verità.
EFFETTO
Può modificare la risorsa ed emettere l'evento di dominio corrispondente.
RIPETIZIONE
In caso di errore di rete, verificare lo stato della risorsa prima di riprovare. Ripristina automaticamente solo 429 e 5xx con backoff e jitter.
Richiesta
idstring · pathIdentificatore della risorsa.minLength 2 · maxLength 100obbligatorionamestring · bodyNome della regola.facoltativoquerystring · bodyParole monitorate.facoltativosourcestring · bodyOrigine o mercato.facoltativosegment_idstring · bodySegmento target.facoltativomin_pricenumber · bodyPrezzo minimo.facoltativomax_pricenumber · bodyPrezzo massimo.facoltativomin_commissionnumber · bodyCommissione minima.facoltativomin_discountnumber · bodySconto minimo.facoltativoorderstring · bodyOrdinamento dei risultati.facoltativolimitinteger · bodyMassimo per round.min 1 · max 100facoltativointerval_minutesinteger · bodyIntervallo tra le ricerche.min 15 · max 10080facoltativoauto_approveboolean · bodyApprova automaticamente i risultati.facoltativoactiveboolean · bodyAttiva il monitoraggio.facoltativoAuthorization
Bearer ach_live_...Accept
application/jsonAmbito
monitors:writeEsempio eseguibile
curl
curl -X PATCH 'https://achadu.com/api/v1/monitors/resource_id' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{
"name": "My integration",
"query": "string",
"source": "string"
}'Risposta ed errori
Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.
200 application/json
{
"data": {
"id": "mon_01J...",
"name": "Air fryers under 350",
"source": "amazon",
"keywords": "air fryer",
"maximum_price": 350,
"active": 1
},
"request_id": "req_01J..."
}200Operazione completata.400Parametro, corpo o transizione non validi.401Chiave mancante, non valida, scaduta o revocata.402Il piano dell'account non rilascia questa interfaccia.403A chave precisa do escopo monitors:write.404La funzionalità non esiste in questo account.409Lo stato attuale impedisce questa operazione.413Il corpo JSON supera i 128 KB.429La finestra di 120 richieste al minuto è stata superata.