API i webhooki.
Połącz z Webmon.

01 / PODSTAWY

Webmon wysyła. Twoja aplikacja odbiera.

Gdy monitoring wykryje ogłoszenia spełniające warunki powiadomień, Webmon wysyła żądanie HTTP POST na adres ustawiony na Twoim koncie. Dane trafiają w treści żądania jako tablica JSON — jedna paczka może zawierać kilka ogłoszeń.

02 / KONFIGURACJA

Pierwszy webhook w trzech krokach

1. 1

   Przygotuj adres odbiorczy

   Utwórz publicznie dostępny endpoint HTTPS przyjmujący POST z JSON-em. Możesz też użyć adresu webhooka wygenerowanego przez narzędzie automatyzacji.

2. 2

   Włącz webhooki w Webmon

   Otwórz Ustawienia konta, zaznacz „przez webhooki”, wklej adres w polu „Adres URL Webhooka (także Discord)” i zapisz zmiany. Wymagany jest pakiet Plus lub wyższy.

3. 3

   Wyślij próbne powiadomienie

   Kliknij „Przetestuj webhook” i sprawdź żądanie po stronie odbiornika. Następnie upewnij się, że masz aktywne monitorowane wyszukiwanie z włączonymi powiadomieniami.

03 / FORMAT JSON

Co znajdziesz w powiadomieniu?

Poniższy przykład przedstawia paczkę z jednym ogłoszeniem wysłaną na własny adres odbiorczy. Wielkość liter w nazwach pól ma znaczenie.

[
  {
    "Title": "Rower miejski — stan bardzo dobry",
    "Url": "https://www.olx.pl/d/oferta/przykladowe-ogloszenie.html",
    "Price": 125000,
    "PhotoUrl": "https://example.com/rower.jpg",
    "IDPortalUrl": 92,
    "UrlTitle": "Rowery w Warszawie",
    "UrlUrl": "https://www.olx.pl/sport-hobby/rowery/warszawa/",
    "TriggerSend": true
  }
]

04 / ADRESY I METODY

Gdzie trafiają żądania?

05 / WŁASNA APLIKACJA

Minimalny odbiornik w Node.js

Przykład używa Express. To szkielet: miejsce zapisu do bazy lub kolejki oznaczyliśmy komentarzem. Po zapisaniu danych szybko zwróć odpowiedź 2xx. Adres z przykładu zastąp swoim endpointem HTTPS. Tajny identyfikator ustaw jako zmienną środowiskową WEBHOOK_SECRET i wpisz ten sam adres w ustawieniach Webmon.

const express = require('express');
const app = express();
const secret = process.env.WEBHOOK_SECRET;
if (!secret) throw new Error('Ustaw WEBHOOK_SECRET');

app.use(express.json({ limit: '1mb' }));
app.post('/webmon/:secret', async (req, res, next) => {
  if (req.params.secret !== secret) return res.sendStatus(404);
  if (!Array.isArray(req.body)) {
    return res.status(400).json({ error: 'Oczekiwano tablicy JSON' });
  }
  try {
    for (const item of req.body) {
      if (!item || typeof item.Url !== 'string') continue;
      // Tutaj trwale zapisz dane lub dodaj je do kolejki.
      // Jeśli wyświetlasz Title w HTML, escapuj jego treść.
    }
    return res.sendStatus(204);
  } catch (error) {
    return next(error);
  }
});

app.listen(3000);

06 / WERYFIKACJA

Sprawdź integrację od końca do końca

Najpierw wyślij lokalną próbkę na swój odbiornik przez cURL. Ta komenda testuje Twoją aplikację; nie wywołuje API Webmon.

curl --request POST \
  'https://twoja-aplikacja.pl/webmon/TAJNY_IDENTYFIKATOR' \
  --header 'Content-Type: application/json' \
  --data '[{"Title":"Test Webmon","Url":"https://example.com/oferta/1","Price":125000}]'

Potem użyj „Przetestuj webhook” w panelu Webmon i sprawdź logi odbiornika. Komunikat „Wysłano pomyślnie” w panelu nie jest potwierdzeniem przetworzenia danych przez Twój serwer. Ostateczną weryfikacją jest odebrane żądanie i poprawny zapis danych.

07 / GOTOWE INTEGRACJE

Wolisz powiadomienia na kanale?

Webmon rozpoznaje adresy webhooków Slacka i Discorda i dopasowuje do nich format wiadomości. W tych integracjach wysyłany jest format platformy: blocks dla Slacka oraz embeds dla Discorda. Do własnej aplikacji użyj zwykłego endpointu, który odbierze tablicę JSON.