Tożsamość i rejestracja aplikacji
Rejestruj zatwierdzone aplikacje, przeglądaj scope’y i zarządzaj governance bez ujawniania tenantowych internals.
[Kuratorowana powierzchnia publiczna]
Integracje API
Knogin publikuje kuratorowany kontrakt integracji zewnętrznej dla auth, tokenów, webhooków i transportu GraphQL. Zaawansowane workflow przechodzą do zweryfikowanego dostępu zamiast być publikowane jako pełny blueprint.
Co obejmuje publiczna powierzchnia
Publiczne wskazówki integracyjne są celowo wąskie i stabilne.
OAuth i service tokens
Używaj wspieranych przepływów dla dostępu delegowanego przez użytkownika lub automatyzacji bez interaktywnego użytkownika.
Dostarczanie zdarzeń i webhooki
Twórz, testuj i monitoruj wychodzące subskrypcje webhooków dla zatwierdzonych workflow.
Kontrakt transportu GraphQL
Łącz się ze współdzielonym transportem GraphQL z bearer auth i tenant scoping, bez publikowania pełnego schematu.
Przykład publicznego kontraktu
Ten przykład pozostaje w granicach zweryfikowanego kontraktu publicznego: uzyskaj token, a następnie wywołaj transport GraphQL.
# Exchange client credentials for a bearer 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"
# Call the shared GraphQL transport
curl https://api.knogin.com/graphql \
-H "Authorization: Bearer <access-token>" \
-H "X-Tenant-Id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{"query":"query HealthCheck { viewer { id } }"}'Zasady integracji
Publiczne, gdy stabilne
Wszystko, co jest dokumentowane publicznie, powinno być wystarczająco stabilne dla zatwierdzonej pracy integracyjnej.
Zweryfikowane, gdy wrażliwe
Zaawansowane workflow platformowe, kuratorowane bundle GraphQL i planowanie zależne od środowiska pozostają za review.
Czytelne maszynowo domyślnie
Ten sam kontrakt publiczny jest dostępny przez `/api/docs`, `llms.txt` i `llms-full.txt`.