Skip to main content

Platform Endpoints

All public application traffic enters through dx-gateway-go on port 8000. Routes are deployment configuration and can be disabled by environment. The inventory below reflects the checked-in Go gateway configuration; service-local OpenAPI documents remain authoritative for individual operations.

Public prefixOwnerGateway authenticationStatus
/iudx/v2/catCatalogueOptional for discovery; writes checked by serviceImplemented
/iudx/v2/authUser ServiceRoute-specificPartially implemented
/aclPolicy ServiceRequiredImplemented
/authzAuthorization ServiceRequired; administrative/debug exposure should be restrictedImplemented
/filesFile ServiceRequiredPartially implemented
/communityCommunity LayerRequiredPartially implemented
/marketplaceMarketplaceRequiredPartially implemented
/marketplace-webhookMarketplaceNo user token; exact callback and provider signature requiredImplemented
/auditAudit ServiceRequiredImplemented
/iudx/v2/resource_serversRegistryPublic reads; privileged writesImplemented
/iudx/v2/acl_serversRegistryPublic reads; privileged writesImplemented
/iudx/v2/subscriptionsSubscription ServiceRequiredImplemented
/ogcOGC Data PlaneRoute-specificPartially implemented
/agents, /agent-templates, /delegationsAgent RegistryRequiredIn development
/agentAgent RuntimeRequired; supports streamingIn development
/approvalsMCP GatewayRequiredIn development
/healthzGatewayNoneImplemented
/sadx/v1Federated extensionsEnvironment-dependentDeferred

The NGSI-LD public-query route and some service routes are not present consistently in every environment. They must not be advertised as operational until the gateway and GitOps route manifests agree and automated route tests pass.

Gateway authentication does not replace service authorization. Services enforce object ownership, organisation scope, and any obligations once canonical resource facts are known. Webhooks use a narrowly matched route and provider-specific signature verification; a path beneath the webhook prefix must not inherit unauthenticated access.

Local service ports are diagnostic/development interfaces, not public contracts. See Deployment Architecture and API Standards.