account/monitors

Crearea unui monitor și prima bază de referință sunt gratuite. Un ciclu de 30 zile se taxează de îndată ce monitorul devine activ. Prețul depinde de intervalul de verificare și acoperă toate verificările pe care intervalul le programează într-un ciclu.

Un interval între două trepte costă cât următoarea treaptă mai frecventă: la fiecare patru zile costă cât la fiecare trei zile.

Verificări suplimentare apar mai ales când scurtezi intervalul în mijlocul unui ciclu. Fiecare verificare suplimentară reușită costă suma din tabel.

După 30 zile, ciclul se reînnoiește automat la prețul valabil atunci. Verificările eșuate nu costă nimic. Când pui pe pauză, arhivezi sau schimbi intervalul, nu rambursăm nimic.

Fiecare cont poate avea până la 50 monitoare în același timp, câte unul per companie. În 24 de ore poți crea până la 50 monitoare; și cele arhivate se socotesc.

Prețul unui interval îl afli gratuit cu GET /v1/account/monitoring/pricing, aici pentru o verificare la fiecare șapte zile:

1. Creare. Numești compania, intervalul de verificare și cel puțin un endpoint webhook verificat. Monitorul pornește cu statusul initializing.
2. Bază de referință. Înregistrăm semnalele din ultimele câteva zile drept cunoscute. Ele nu se livrează, deci primești doar ce e nou după aceea.
3. Activare. Taxăm ciclul, monitorul devine active și verifică imediat prima dată.
4. Verificare. Apoi verifică la intervalul ales. Fiecare semnal nou declanșează câte un mesaj per monitor către endpointurile tale webhook.
5. Reînnoire. După fiecare ciclu, următorul se taxează automat, cât timp soldul tău îl acoperă.

Intervalul de verificare este între 1 și 30 zile. Momentul exact al unei verificări poate varia în cadrul unei ore. Fiecare verificare privește câteva zile în urmă, așa că sosesc și înscrierile publicate târziu.

Un monitor livrează temele Signals ale planului tău: cinci în orice cont, Insolvențele cu Pro, Transformările & M&A cu Max. Un webhook poartă același semnal în câmpul data.signal ca signals.

Pentru monitoarele puse pe pauză și pentru erori, status_reason explică de ce, de exemplu no_verified_endpoint sau insufficient_cycle_floor.

Toate căile se află sub /v1/account. Citești și scrii cu cheia ta API în headerul x-api-key.

Fiecare cerere de scriere are nevoie de headerul Idempotency-Key, o valoare unică per operație, ideal un UUID. Fără el, API-ul răspunde cu 428.

Dacă repeți o cerere cu aceeași cheie și aceleași date în 24 de ore, primești înapoi răspunsul salvat. Acesta poartă headerul Idempotency-Status: replayed. Astfel o eroare de rețea nu creează un al doilea monitor.

Asta se aplică și răspunsurilor de eroare. Pentru o încercare nouă după o corectură folosește deci o cheie nouă. Aceeași cheie cu alte date returnează 409.

Sunt permise până la 128 de caractere: litere, cifre și . _ : -. Primul caracter este o literă sau o cifră. O cheie în orice alt format returnează 400.

Ai nevoie de entity_id-ul companiei și de cel puțin un endpoint webhook verificat, vezi account/webhook-endpoints.

API-ul răspunde cu 202: monitorul e creat, iar baza de referință și activarea rulează în fundal. meta.billing.charged_credits arată că nu s-a taxat nimic pentru asta.

GET /v1/account/monitors returnează până la 100 monitoare sub monitors, cu total. Cele arhivate nu sunt în listă.

GET /v1/account/monitors/{id} arată în plus ciclul curent în billing_cycle și ultimele verificări în recent_runs.

PATCH /v1/account/monitors/{id} schimbă intervalul de verificare. Următoarea verificare urmează atunci la noul interval, socotit de la schimbare.

Ciclul curent își păstrează prețul și verificările incluse. Noul preț se aplică de la următorul ciclu. Un interval mai scurt poate declanșa verificări suplimentare în ciclul curent.

POST …/{id}/pause oprește un monitor activ. Ciclul plătit continuă până la capăt și nu se rambursează nimic.

POST …/{id}/resume reia un monitor pus pe pauză sau un monitor cu eroare. Verificăm din nou endpointurile webhook, soldul și prețul.

În cadrul ciclului plătit curent, reluarea nu costă nimic. Dacă ciclul s-a încheiat, începe acum un ciclu nou la prețul actual. meta.request_credit_cost arată suma.

Dacă, de exemplu, lipsește un endpoint webhook verificat, API-ul răspunde totuși cu 200, dar cu meta.activated: false. Statusul monitorului și status_reason indică motivul.

Dacă prețul s-a schimbat, un monitor activ se oprește la sfârșitul ciclului cu pricing_consent_required. Cu resume accepți noul preț.

DELETE …/{id} arhivează monitorul definitiv. Este ireversibil și nu se rambursează nimic.

Erorile au structura {"error": "…", "meta": {"message": "…"}}. În programul tău verifică valoarea lui error. Textul din meta.message este în engleză și se poate schimba. Erorile nu costă nimic.