DOBRUK API

Publiczne API i webhooki dla dobruk.pl (OPUB, daycard, integracje)

Ta subdomena jest przeznaczona wyłącznie do endpointów API i webhooków (np. WhatsOnChain plugin).

Otwórz dokumentację jako JSON Dokumentacja protokołu OPUB OPUB Explorer / Wyszukiwarka

`/daycard.php`

GET

Opis: API „kartka z kalendarza”. Zwraca kartkę dla podanej daty (domyślnie dzisiaj wg Europe/Warsaw).

PARAMETRY

date (query) — opcjonalny • string • YYYY-MM-DD

Docelowa data. Jeśli brak lub błędna – API użyje dzisiejszej (Europe/Warsaw).

POLA ODPOWIEDZI

ok: boolean
date: string (YYYY-MM-DD)
offset: int (days difference relative to today)
pretty_date: string (Polish formatted date label)
week_no: int (ISO week number)
day_of_year: int
days_in_year: int (365/366)
is_today: boolean
card: object|null
card.title: string
card.lead: string
card.names: string
card.events: string[]
card.astro: string[]

UWAGI

- Strefa czasowa: Europe/Warsaw.
- Kartka jest szukana po miesiącu+dniu (bez roku) w tabeli calendar__card.
- Locale jest ustawione na pl-PL, zwracane są tylko aktywne wpisy (status_id=1).
- Jeśli brak wpisu dla danej daty – pole "card" ma wartość null.

Przykład: https://api.dobruk.pl/daycard.php?date=2025-12-10

PRZYKŁADOWA ODPOWIEDŹ (JSON)

{
    "ok": true,
    "date": "2025-12-10",
    "offset": 0,
    "pretty_date": "środa, 10 grudnia 2025",
    "week_no": 50,
    "day_of_year": 344,
    "days_in_year": 365,
    "is_today": true,
    "card": {
        "title": "...",
        "lead": "...",
        "names": "...",
        "events": [
            "...",
            "..."
        ],
        "astro": [
            "...",
            "..."
        ]
    }
}

`/woc/opub/decode.php`

GET

Opis: Webhook dla pluginu Data na WhatsOnChain (OPUB / NFT.*). Wykrywa treści OPUB-like (np. type=nft.article) i zwraca HTML viewer.

PARAMETRY

network (query) — wymagany • string • main|test|stn

Nazwa sieci z placeholdera WhatsOnChain {network}.

tx (query) — wymagany • string • txid (64 hex)

TXID z placeholdera WhatsOnChain {tx}.

voutindex (query) — wymagany • int • >=0

Indeks vout z placeholdera WhatsOnChain {voutindex}.

view (query) — opcjonalny • string • debug

Opcjonalne. Jeśli ustawisz "debug", endpoint może pokazać surowe chunki OP_RETURN (diagnostyka).

UWAGI

- Endpoint projektowany pod system pluginów WhatsOnChain.
- Zwraca HTML (viewer).

Przykład: https://api.dobruk.pl/woc/opub/decode.php?network=main&tx=70c36d3a482bdc7c60ef0fd5bb90a5beaefe68824025d1947acc15ad1a14b284&voutindex=0

`/healthz.php`

GET

Opis: Prosty endpoint „żyje / działa” (opcjonalny).

Przykład: https://api.dobruk.pl/healthz.php