Premiers pas avec gRPC

Premiers pas avec l’API gRPC de KiloCenter — vérifiez la connectivité locale au port 9090 de KC-Core avec grpcurl, listez les services.

Objectif

Vérifiez la connectivité gRPC locale vers KC-Core et découvrez les méthodes d’API disponibles.

Vérifier l’accessibilité du service

grpcurl -plaintext localhost:9090 list

Inspecter le service principal

grpcurl -plaintext localhost:9090 describe kilocenter.api.v1.KiloCenterService

Vérifier le service de santé gRPC

grpcurl -plaintext localhost:9090 grpc.health.v1.Health/Check

Appeler une méthode d’API de base

grpcurl -plaintext -d '{}' \
  localhost:9090 kilocenter.api.v1.KiloCenterService/GetSystemStatus

Authentification et contexte de l’organisation

L’édition Community fonctionne avec l’authentification désactivée par défaut en mode développement. Les commandes gRPC ci-dessus fonctionnent sans en-têtes d’authentification dans cette configuration.

Si vous activez l’authentification (édition Enterprise ou en définissant KILOCENTER_AUTH_ENABLED=true), incluez des en-têtes de métadonnées dans les appels gRPC :

grpcurl -plaintext \
  -H "authorization: Bearer <JWT_TOKEN>" \
  -H "x-organization-id: <ORG_ID>" \
  -d '{}' \
  localhost:9090 kilocenter.api.v1.KiloCenterService/GetSystemStatus

Étape suivante

Utilisez la référence complète de l’API pour les contrats de requête/réponse :

• kilocenter-modules/docs/api.md