Dokumentacja
Kuratorowane publiczne wskazówki dla integracji zewnętrznych, ścieżek z przeglądem dostępu, opcji wdrożenia na wysokim poziomie, zgłoszeń bezpieczeństwa i dokumentacji czytelnej maszynowo.
API Integracji Zewnętrznych
Stabilny publiczny kontrakt dla rejestracji aplikacji, OAuth, JWKS, webhooków i transportu GraphQL.
/docs/api-referencePrzewodnik Integracji
Zalecana ścieżka dla zatwierdzonych integracji i wniosków o zweryfikowany dostęp.
/docs/integration-guideOpcje Wdrożenia
Modele wdrożenia na wysokim poziomie i materiały udostępniane podczas review rozwiązania.
/docs/deploymentDokumentacja Bezpieczeństwa
Proces zgłaszania i publiczne wskazówki dla bezpiecznych praktyk integracyjnych.
/docs/securityDostęp AI
Publiczna dokumentacja czytelna maszynowo przez `llms.txt`, `llms-full.txt` i `/api/docs`.
/docs/ai-accessObservability i tracing
W3C Trace Context, OpenTelemetry, X-Argus-Trace-ID.
/docs/observability-and-tracingJoby asynchroniczne
Kolejkuj długotrwałe zadania, sprawdzaj status i odbieraj podpisane webhooki.
/docs/async-jobsŚrodowisko sandbox
Testuj integracje z deterministycznymi mock-konektorami bez ruchu wychodzącego do live partnera.
/docs/sandbox-environmentProvenance i zgodność
Podpisane, Merkle-łańcuchowane transkrypcje każdej operacji na evidence; PROV-O JSON-LD; HMAC domyślnie z PQC opt-in.
/docs/provenance-and-complianceDiscovery i governance
Zgodne ze standardami discovery API (OpenAPI RFC 8615, katalog RFC 9727) oraz nagłówki Sunset/Deprecation.
/docs/discovery-and-governanceSzybki start integracji publicznej
Zacznij od kuratorowanego publicznego kontraktu. O dostęp z przeglądem występuj tylko wtedy, gdy workflow wymaga funkcji partnerskich lub onboardingu zależnego od środowiska.
# Discover the public documentation surface
curl https://knogin.com/api/docs | jq .
# Review the app registration contract
curl https://auth.knogin.com/v1/platform/scopes \
-H "Authorization: Bearer <admin-access-token>"
# Exchange an approved client for a token
curl -X POST https://auth.knogin.com/v1/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=<client-id>&client_secret=<client-secret>&scope=webhooks:write"Przykłady poleceń pozostają w kanonicznym angielskim, ponieważ bezpośrednio odpowiadają publicznej powierzchni API.