DOKUMENTACJA TECHNICZNA

API portalu CPP Connector.

JSON, adresy względne /api, sesje ciasteczkowe dla CMS. To API portalu informacyjnego, nie kontrakt produkcyjnego CPP Connector.

Kontrolowany dostęp i rejestrowanie operacji w systemie danych produktowych — Role, kontrola dostępu i historia operacji chronią proces publikacji.Wizualizacja wygenerowana przy użyciu AI.

KONTRAKT INTEGRACYJNY

Stabilny interfejs oddziela źródła klienta od modelu paszportu.

API umożliwia przekazywanie ustandaryzowanych dokumentów wejściowych, sprawdzanie wyniku walidacji i obsługę kolejnych wersji. Klient nie musi ujawniać struktury lokalnych tabel ani sposobu działania swoich systemów.

Pokazane niżej endpointy należą do portalu demonstracyjnego. Produkcyjny kontrakt CPP HUB powinien być wersjonowany, idempotentny i przygotowany do przetwarzania masowego, kolejek, ponowień oraz diagnostyki błędów.

Ustandaryzowane dane wejściowe

Integracja przekazuje model CPP zamiast lokalnych nazw tabel i kolumn.

Czytelne wyniki kontroli

Odpowiedź wskazuje braki i działania wymagane od klienta.

Skalowanie i ponowienia

Operacje masowe wymagają kolejek, limitów i ochrony przed duplikatami.

Metoda	Endpoint	Opis
`GET`	`/api/catalog`	Opublikowany katalog treści i demonstracji.
`GET`	`/api/passports/{slug}`	Dane paszportu demonstracyjnego.
`GET`	`/api/health`	Stan połączenia z bazą. Kod 503 oznacza niedostępność.
`GET`	`/api/csrf`	Token do operacji zmieniających stan.
`POST`	`/api/leads`	Zapis zgłoszenia biznesowego lub technicznego.
`POST`	`/api/newsletter`	Zapis wymagający potwierdzenia e-mail.
`POST`	`/api/auth/login`	Uwierzytelnienie administratora lub redaktora.
`GET`	`/api/admin/documents`	Dokumenty CMS (wymagana sesja).
`PUT`	`/api/admin/documents/{id}`	Szkic z kontrolą expectedRevision (redaktor).
`POST`	`/api/admin/documents/{id}/publish`	Publikacja całej rewizji strony lub dokumentu.

Pobranie przykładowego paszportu

GET /api/passports/voltera-vx82
Accept: application/json

Ochrona żądań

Przed POST, PUT, PATCH i DELETE pobierz /api/csrf, zachowaj ciasteczko i przekaż token w nagłówku X-CSRF-TOKEN. Kod 409 oznacza konflikt wersji. Kod 429 wymaga odczekania. Formularze mają limit 8 żądań na minutę na adres IP.

Omów integrację