Nové

Lead Collection

Automatické doručování nových zakázek dle vašich filtrů — region, klíčová slova, rozsah hodnot, CPV kódy. Pull API + email digest + webhook.

Správa filtrů

GET/api/v1/leads/filtersSeznam filtrů

POST/api/v1/leads/filtersVytvořit filtr

PUT/api/v1/leads/filters/:idUpravit filtr

DELETE/api/v1/leads/filters/:idSmazat filtr

Body parametry (POST / PUT)

Parametr	Typ	Popis
name*	string	Název filtru
regions	string[]	NUTS kódy regionů (např. CZ010)
keywords	string[]	Klíčová slova pro fulltext v názvu
minValue	number	Min. odhadovaná hodnota zakázky
maxValue	number	Max. odhadovaná hodnota zakázky
categories	string[]	CPV kódy (prefix match)
webhookUrl	string	URL pro webhook notifikace
emailDigest	boolean	Denní email digest (výchozí: true)

Příklad: vytvoření filtru

curl -X POST -H "X-API-Key: mrw_leads_klíč" \
  -H "Content-Type: application/json" \
  -d '{"name":"Stavby Praha","regions":["CZ010"],"keywords":["most","silnice"],"minValue":500000}' \
  "https://mrickwood.cz/api/v1/leads/filters"

Získání matchů

GET/api/v1/leadsNové zakázky dle filtrů

Query parametry

Parametr	Typ	Popis
filter_id	string	Filtrovat dle konkrétního filtru
since	string	Pouze matche od data (ISO datetime)
delivered	boolean	false = jen nedoručené, true = jen doručené
limit	number	Počet výsledků, max 200 (výchozí: 50)

Vrácené matche jsou automaticky označeny jako delivered=true. Každý request spotřebuje 1 kredit.

Příklad

curl -H "X-API-Key: mrw_leads_klíč" \
  "https://mrickwood.cz/api/v1/leads?delivered=false&limit=10"

Odpověď

{
  "leads": [
    {
      "matchId": "cm...",
      "filterId": "cm...",
      "filterName": "Stavby Praha",
      "tenderId": "12345",
      "matchedAt": "2026-04-03T06:00:00.000Z",
      "delivered": true,
      "tender": {
        "id": "12345",
        "title": "Rekonstrukce mostu ev.č. 123",
        "estimatedValue": 12500000,
        "deadline": "2026-05-15",
        "portalUrl": "https://nen.nipez.cz/...",
        "region": "CZ010"
      }
    }
  ],
  "count": 1
}

Webhook

Pokud nastavíte webhookUrl na filtru, systém při nalezení nových matchů pošle POST na váš endpoint. Payload obsahuje HMAC-SHA256 podpis v hlavičce X-Signature-256. Webhook secret obdržíte při vytvoření filtru. Při selhání se retry provede 3x s exponenciálním backoffem.

Email digest

S emailDigest: true dostanete denní email s přehledem nových zakázek. Digest se odesílá ráno (5:00 UTC) na email vašeho účtu. Lze vypnout editací filtru.