Monitory
Utwórz radar
Utwórz wyszukiwanie cykliczne z kryteriami komercyjnymi.
POST
/monitorsmonitors:writeZACHOWANIE
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
namestring · bodyNazwa reguły.obowiązkowequerystring · bodyMonitorowane słowa.obowiązkowesourcestring · bodyŹródło lub rynek.opcjonalnesegment_idstring · bodySegment docelowy.opcjonalnemin_pricenumber · bodyCena minimalna.opcjonalnemax_pricenumber · bodyCena maksymalna.opcjonalnemin_commissionnumber · bodyMinimalna prowizja.opcjonalnemin_discountnumber · bodyMinimalny rabat.opcjonalneorderstring · bodyKolejność wyników.opcjonalnelimitinteger · bodyMaksymalnie na rundę.min 1 · max 100opcjonalneinterval_minutesinteger · bodyOdstęp między wyszukiwaniami.min 15 · max 10080opcjonalneauto_approveboolean · bodyAutomatycznie zatwierdza wyniki.opcjonalneactiveboolean · bodyAktywuje monitorowanie.opcjonalneAuthorization
Bearer ach_live_...Accept
application/jsonZakres
monitors:writePrzykład wykonywalny
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
}'Odpowiedź i błędy
Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.
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..."
}201Zasób został utworzony i utrwalony.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ę.