Dla agencji · software house'ów · freelancerów

Zbuduj front po swojemu.
Dane weź z wtyczki.

Deweloper chce stronę według własnego projektu, a jednocześnie musi codziennie raportować ceny do dane.gov.pl. Wtyczka DeweloperCeny.pl robi to drugie i oddaje Wam pierwsze: publiczne API tylko do odczytu z lokalami, cenami, historią zmian i najniższą ceną z 30 dni. Wy budujecie widok, wtyczka pilnuje ustawy.

Pobierz dokumentację API (PDF) Otwórz demo z działającym API
  • JSON natywny REST WordPressa
  • Bez klucza dane jawne z mocy ustawy
  • v1 adresy i pola stałe
  • 0 zmian w raporcie dane.gov.pl
Jak to wygląda w praktyce

Trzy kroki, żaden nie wymaga naszego udziału w Waszym kodzie

1

Deweloper kupuje licencję

Licencja jest na jego domenę, bezterminowa, z aktualizacjami przy zmianie przepisów. Możecie kupić w jego imieniu i rozliczyć w projekcie. Wtyczka wgrywa się w panelu WordPress w dwie minuty.

2

Wy budujecie front na dokumentacji i demo

Dokumentacja opisuje każdy adres i każde pole z przykładami odpowiedzi. Demo ma fikcyjną inwestycję z działającym API, więc pierwszy fetch robicie od razu, zanim klient wprowadzi choć jeden lokal.

3

Wdrożenie i spokój z ustawą

Deweloper prowadzi ceny w panelu wtyczki albo importuje cennik z Excela. Wasz front czyta dane z API, a raport do dane.gov.pl idzie sam co noc. Zmiany przepisów obsługuje wtyczka, nie Wasz kod.

Co dostajecie z API

Sześć adresów, które pokrywają listę, kartę lokalu i sekcję „inne lokale"

Prefiks każdego z nich to https://domena-dewelopera.pl/wp-json/deweloper-oferty/v1/. Odpowiedzi w JSON, bez logowania.

inwestycje

Lista inwestycji z adresem, liczbą lokali i licznikami statusów. Wypełnia zakładki „Wszystkie · Dostępne · Sprzedane" bez pobierania listy.

inwestycje/{id}/lokale

Lokale inwestycji z filtrem statusu, sortowaniem po cenie, powierzchni, pokojach lub numerze, ze stronicowaniem.

lokale/{id}

Karta lokalu: ceny, dodatki, strona świata, opis, grafiki (render, położenie na osiedlu, rzuty, karta PDF), historia cen i najniższa z 30 dni.

lokale/{id}/podobne

Inne lokale tej inwestycji, najpierw dostępne, potem zarezerwowane. Gotowe pod sekcję „Inne lokale w tej inwestycji".

lokale/{id}/historia

Sama historia zmian ceny: kwoty przed i po zmianie z datą. Pod wykres albo tabelę na karcie.

inwestycje/{id}

Jedna inwestycja: adres, deweloper, prospekt, termin ukończenia.

Stały identyfikator lokalu. Nie zmienia się przy edycji ani przy ponownym imporcie cennika. Do własnych powiązań i ukrytego pola w formularzu.
Ukryte ceny są ukryte też w API. Jeśli deweloper chowa ceny sprzedanych, dostajecie null i flagę ceny_ukryte. Front nie ma jak tego obejść, więc jest zgodny z ustawą sam z siebie.
Pola pod kartę produktu. Strona świata, opis (description) i nazwane grafiki: render do listy, położenie na osiedlu, rzuty. Deweloper ustawia je w panelu lub importuje z pliku.
Omnibus obowiązkowo. Pole najnizsza_30_dni musi być widoczne przy cenie. Wpiszcie je w projekt karty od razu, żeby nie wracać.
Pobierz dokumentację API (PDF) Wypróbuj adresy w demo Dokumentacja jest częścią instrukcji obsługi wtyczki, więc deweloper i Wy patrzycie w ten sam dokument.
Współpraca z agencjami

Jedna wtyczka, wielu deweloperów, zero utrzymania po Waszej stronie

Agencja, która obsługuje kilku deweloperów, ma jeden problem prawny do rozwiązania wielokrotnie. Z wtyczką rozwiązujecie go raz: ten sam model danych, te same adresy API, ta sama dokumentacja u każdego klienta. Zmiany przepisów wchodzą aktualizacją wtyczki, nie poprawkami w każdym projekcie.

  • Licencja na domenę klienta, faktura na wskazany podmiot: na dewelopera albo na Was.
  • Instalacja i aktywacja po Waszej stronie zajmuje dwie minuty; na życzenie robimy ją my.
  • Wsparcie techniczne przy wdrożeniu API dla Waszego zespołu, bez pośredniczenia klienta.
  • Środowisko testowe pod konkretny projekt, jeśli publiczne demo to za mało.
  • Przy stałej współpracy warunki partnerskie: napiszcie, ustalimy je pod Waszą skalę.
  • Nie chcecie robić frontu sami? Zrobimy stronę dewelopera pod klucz i oddamy Wam gotowy serwis.
Napisz w sprawie współpracy kontakt@codescriptum.pl
Licencja bezterminowa Płacisz raz, wtyczka zostaje u Ciebie na stałe. Bez abonamentu i bez daty ważności.
12 miesięcy gwarancji Błąd w działaniu wtyczki albo API usuwamy bezpłatnie przez rok od instalacji.
Aktualizacje przy zmianie przepisów Gdy zmienia się ustawa albo wymagania dane.gov.pl, dostajesz nową wersję bez dopłaty.
Paczka i klucz w 24 h Wtyczkę, klucz licencji i instrukcje wysyłamy e-mailem. Wgrywasz w panelu WordPress w 2 minuty.
FAQ

Pytania, które agencje zadają przed pierwszym wdrożeniem

Tak. API odpowiada każdej stronie, która o dane zapyta (tak działa REST WordPressa). Deweloper może w ustawieniach wtyczki zawęzić dostęp z przeglądarki do wybranych domen, ale nie musi. Front na tej samej instalacji WordPressa działa zawsze.

Licencja jest na domenę dewelopera, więc najczęściej kupuje ją deweloper, a agencja robi wdrożenie. Jeśli wolicie kupić w imieniu klienta i rozliczyć w projekcie, też tak można. Fakturę wystawiamy na wskazany podmiot.

Nic. Wersja API jest stała, pola tylko dochodzą, nigdy nie znikają ani nie zmieniają nazwy. Zmiany przepisów wchodzą po stronie wtyczki, front nie musi ich znać.

Dokumentacja API jest do pobrania z tej strony. Do testów służy publiczne demo z fikcyjną inwestycją i działającymi adresami API. Na życzenie stawiamy też osobne środowisko dla Waszego projektu.