Przejdź do treści
pozyskajpacjenta (strona główna)
Zaloguj sięUmów prezentację
Umów prezentację
Załóż konto placówkiZaloguj się

Dla programistów

API, webhooki i SDK na publicznym kontrakcie

API v1 zmieniamy tylko addytywnie, więc istniejące pola i adresy zostają tam, gdzie były. Zapytania z własnego frontu, formularzy reklam i integracji trafiają na tę samą listę w panelu co zapytania ze strony. Aktualna wersja: 1.26.1.

Umów prezentacjęZałóż konto placówki
Zapytania przykładowej placówki Ginekologia Nawłoć na telefonie: kolejki z licznikami, źródło i etap każdego zapytania
Zapytania przykładowej placówki Ginekologia Nawłoć: kolejki z licznikami, źródło każdego zapytania i etap
Zapytania przykładowej placówki Ginekologia Nawłoć na telefonie: kolejki z licznikami, źródło i etap każdego zapytania
Przykładowa placówka Ginekologia Nawłoć: nazwa, zespół i dane pacjentów są fikcyjne. Ekran z działającego panelu.Przykładowa placówka Ginekologia Nawłoć: nazwa, zespół i dane pacjentów są fikcyjne. Ekran z działającego panelu.

  • Tylko zmiany addytywne

    Nowe pola i adresy dochodzą obok istniejących. Zmiana, której nie da się dodać obok, trafia do nowej wersji, obok v1.

  • Podpisane webhooki

    Nowe zapytanie przychodzi na Twój adres jako zdarzenie „lead.created” z podpisem HMAC‑SHA256.

  • Ta sama lista w panelu

    Recepcja obsługuje zapytanie z API tak samo jak zapytanie ze strony, z tymi samymi etapami obsługi.

Jak to połączyć

  1. 01Placówka

    Generujesz klucz API

    W Ustawieniach, w Integracjach, generujesz klucz API placówki. Klucz widać tylko raz, więc zapisujesz go od razu.

  2. 02Placówka

    Twój front wysyła zapytanie

    Formularz na Twojej stronie albo integracja wysyła zapytanie przez SDK w TypeScript albo zwykłym wywołaniem API v1.

  3. 03Zespół pozyskajpacjenta.pl

    Zapytanie trafia na listę

    Zapytanie pojawia się na liście w panelu, recepcja dostaje e‑mail, a Twój adres webhooka podpisane zdarzenie „lead.created”.

Co robi Twój kod, a co pozyskajpacjenta.pl

Po stronie Twojego kodu

  • Wygląd formularza i strony, na której stoi
  • Odbiór webhooków i sprawdzenie podpisu
  • Własne integracje, które czytają nowe zapytania

Robi pozyskajpacjenta.pl

  • Lista zapytań z etapami i e‑mail do recepcji
  • Zabiegi, cennik, zespół i wolne terminy przez API v1
  • Rezerwacja online z grafiku w panelu
  • Dokumentacja, opis OpenAPI i SDK w TypeScript

Formularz na Twojej stronie, zapytanie w panelu

SDK ma typy z tego samego kontraktu co API v1. Zapytanie wysłane przez createLead trafia na tę samą listę co zapytanie ze strony placówki, a webhook „lead.created” przychodzi z podpisem, który sprawdzasz przed odczytaniem treści.

@pozyskajpacjenta/sdk · API v1 1.26.1
import { PozyskajPacjentaClient } from "@pozyskajpacjenta/sdk";

const pp = new PozyskajPacjentaClient({
  baseUrl: "https://app.pozyskajpacjenta.pl",
  apiKey: process.env.PP_API_KEY,
});

// formularz na Twojej stronie → lista zapytań w panelu
await pp.createLead({ name, phone });

Częste pytania

Czy API może się zmienić i zepsuć moją integrację?

API v1 to publiczny kontrakt: zmieniamy je tylko addytywnie, więc istniejące pola i adresy zostają. Zmiana, której nie da się dodać obok, trafia do nowej wersji, obok v1.

Jak sprawdzić, że webhook przyszedł od Was?

Każdy webhook ma podpis HMAC‑SHA256 z sekretem Twojego adresu. Sprawdź podpis, zanim odczytasz treść; przykład jest w dokumentacji webhooków.

Czy zapytanie z API widać tak samo jak ze strony?

Tak. Zapytania z własnego frontu, formularzy reklam i integracji trafiają na tę samą listę w panelu, z etapami i e‑mailem do recepcji.

Gdzie jest pełny opis API?

Na /docs: pierwsze kroki, klucze API, webhooki, SDK w TypeScript i opis każdego adresu w formacie OpenAPI.

Zobacz też

Pokażemy panel, do którego trafiają Twoje zapytania

Na rozmowie pokazujemy listę zapytań, etapy i kartę pacjenta, a Twój programista dostaje adres dokumentacji.

Umów prezentacjęZałóż konto placówki