Przejdź do treści
AchaduDevelopers
Developers/API/monitor_update
Monitory

Zaktualizuj radar

Aktualizuje kryteria, częstotliwość i automatyzację.

PATCH/monitors/{id}monitors:write
ZACHOWANIE

Zmiana zostanie zweryfikowana i utrwalona na koncie kluczowym przed udzieleniem odpowiedzi. Zapytaj zwrócony zasób jako źródło prawdy.

EFEKT

Może zmienić zasób i wyemitować odpowiednie zdarzenie domeny.

POWTÓRKA

W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.

Żądanie

idstring · pathIdentyfikator zasobu.minLength 2 · maxLength 100obowiązkowe
namestring · bodyNazwa reguły.opcjonalne
querystring · bodyMonitorowane słowa.opcjonalne
sourcestring · bodyŹródło lub rynek.opcjonalne
segment_idstring · bodySegment docelowy.opcjonalne
min_pricenumber · bodyCena minimalna.opcjonalne
max_pricenumber · bodyCena maksymalna.opcjonalne
min_commissionnumber · bodyMinimalna prowizja.opcjonalne
min_discountnumber · bodyMinimalny rabat.opcjonalne
orderstring · bodyKolejność wyników.opcjonalne
limitinteger · bodyMaksymalnie na rundę.min 1 · max 100opcjonalne
interval_minutesinteger · bodyOdstęp między wyszukiwaniami.min 15 · max 10080opcjonalne
auto_approveboolean · bodyAutomatycznie zatwierdza wyniki.opcjonalne
activeboolean · bodyAktywuje monitorowanie.opcjonalne
AuthorizationBearer ach_live_...
Acceptapplication/json
Zakresmonitors:write

Przykład wykonywalny

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"
}'

Odpowiedź i błędy

Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.

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..."
}
200Operacja zakończona.
400Nieprawidłowy parametr, treść lub przejście.
401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.
402Plan konta nie udostępnia tego interfejsu.
403A chave precisa do escopo monitors:write.
404Funkcja nie istnieje na tym koncie.
409Obecny stan uniemożliwia tę operację.
413Treść JSON przekracza 128 KB.
429Przekroczono okno 120 żądań na minutę.