Czy przetarg.eu ma API?

Tak. Publiczne API tylko do odczytu jest dostępne w planach Plus i Pro. Klucz tworzysz w panelu w sekcji Integracje, autoryzacja idzie nagłówkiem X-Api-Key, limit wynosi 600 zapytań na godzinę na klucz.

Czy mogę czytać trafienia w czytniku RSS?

Tak. Każdy monitor ma własny kanał RSS, jest też kanał z pipeline. Adres zawiera sekret i działa bez logowania, a wymiana adresu w panelu unieważnia stare linki.

Czy da się połączyć przetarg.eu z Zapierem albo Make?

Tak. Webhook w formacie własnego odbiornika wysyła czysty JSON, który przyjmuje Webhooks by Zapier, Custom webhook w Make oraz moduł Webhook w n8n. Wystarczy wkleić adres z ich kreatora w polu webhooka monitora.

Integracje: przetargi tam, gdzie pracujesz

Q: Jak dostać przetargi na Slacku albo w Teams?

W edytorze monitora wklej adres webhooka ze Slacka, Teams albo Discorda. Format rozpoznajemy po adresie, więc wiadomość wygląda natywnie w każdym z tych komunikatorów. Webhooki są częścią planu Pro.

Monitoring ma sens, gdy trafienie dociera do właściwej osoby bez logowania się gdziekolwiek. przetarg.eu wypuszcza dane na zewnątrz sześcioma drogami - od kanału RSS po własne API.

6endpointów API tylko do odczytu

4formaty webhooka

600zapytań na godzinę na klucz

10 minodświeżanie kanałów RSS

Publiczne API

Klucz tworzysz sam w panelu, w sekcji Integracje. Jest pokazywany jeden raz - trzymamy wyłącznie jego skrót. Autoryzacja idzie nagłówkiem X-Api-Key albo Authorization: Bearer.

Pierwsze zapytanie

curl -H "X-Api-Key: pk_live_..." \
  https://przetarg.eu/api/v1/tender/monitors

/me - plan, limity i dane klucza.
/monitors - Twoje monitory wraz z kryteriami.
/monitors/{id}/results - ogłoszenia zebrane przez monitor.
/tracked - pipeline: obserwowane, przygotowywane i złożone.
/search?q= - wyszukiwarka tą samą składnią co monitor.
/categories - branże z licznikami ogłoszeń.

API działa w planach Plus i Pro. Odpowiedzi niosą pole źródła; przy dalszej publikacji ogłoszeń z TED zachowaj wskazanie źródła (© Unia Europejska, ted.europa.eu).

Webhooki: Slack, Teams, Discord i własny odbiornik

Każdy monitor może wysyłać nowe trafienia na adres webhooka. Format rozpoznajemy po adresie, więc wiadomość wygląda natywnie w każdym komunikatorze - a nie jak zrzut JSON-a.

Slack - wiadomość w Block Kit z tytułem, zamawiającym i terminem.
Microsoft Teams - Adaptive Card przez Workflows.
Discord - embeds, do dziesięciu pozycji w jednej wiadomości.
Własny odbiornik - czysty JSON podpisany HMAC-SHA256 w nagłówku X-Przetarg-Signature.

Przycisk „Wyślij test" w panelu nadaje próbną wiadomość, więc sprawdzasz połączenie bez czekania na kolejny skan. Webhooki są częścią planu Pro.

Kanały RSS

Każdy monitor ma własny kanał RSS, jest też kanał z pipeline. Adres działa bez logowania, bo zawiera sekret - i dlatego traktuj go jak hasło. Wymiana adresu w panelu unieważnia stare linki, łącznie z kalendarzem.

Kalendarz terminów

Terminy składania ofert trafiają do Kalendarza Google, Outlooka albo Apple przez subskrypcję webcal. Kalendarz aktualizuje się sam, gdy zmienia się termin w ogłoszeniu albo dochodzi nowe postępowanie.

Zapier, Make i n8n

Bez pisania kodu: w Zapier wybierz Webhooks by Zapier i akcję Catch Hook, w Make Custom webhook, w n8n moduł Webhook. Adres z ich kreatora wklej w polu webhooka monitora i zostaw format własnego odbiornika - dostaniesz czysty JSON z listą ogłoszeń.

Zacznij od kanału RSS

Kanały RSS i kalendarz działają w każdym planie, także darmowym. API i webhooki dokładasz, gdy przetargi mają płynąć wprost do Twoich narzędzi.

Załóż konto za darmo

Pytania

Czy API pozwala zakładać monitory?

Nie. Publiczne API jest wyłącznie do odczytu - monitory zakładasz i edytujesz w panelu albo w aplikacji. Taki zakres ogranicza skutki wycieku klucza.

Co się stanie, gdy przekroczę limit zapytań?

Dostaniesz odpowiedź 429 wraz z nagłówkami mówiącymi, ile zapytań zostało i kiedy limit się odnowi. Limit liczy się osobno dla każdego klucza.

Jak sprawdzić, że webhook przyszedł naprawdę od nas?

W formacie własnego odbiornika liczymy HMAC-SHA256 z surowego ciała żądania i wysyłamy je w nagłówku X-Przetarg-Signature. Sekret znajdziesz w panelu i możesz go wymienić w każdej chwili.

Czy mogę odciąć dostęp konkretnej integracji?

Tak. Klucz API odwołujesz pojedynczo, a adresy RSS i kalendarza unieważniasz wymianą adresu. Każde z tych zdarzeń zapisujemy w dzienniku konta.

Pełny opis funkcji znajdziesz w panelu, w sekcji Integracje. Źródła danych i zasady ich ponownego wykorzystania opisuje sekcja Źródła danych oraz Regulamin.