Developer Platform & Marketplace

An internal developer portal, the API gateway, docs, value-ops and FinOps.

The developer plane: a DevPortal with golden paths, scorecards and a service catalog; the API gateway that admits and routes external traffic with entitlements; a docs plane that keeps API references fresh and drift-checked; ValueOps for product bets, OKRs and prioritization; and FinOps for budgets, cost anomalies, allocation and unit economics.

Auth is one model across every service here — an SS-01 bearer token plus X-Tenant-Id on every /api/v1 route. Public base https://api.nexocloud.io/api/v1.

5 real backends, 98 operations.

Every path below is a real route from services/<svc>/openapi.json. Each service lists a representative slice of its full contract.

DevPortal SS-51

26 operations

Internal developer portal — golden paths, blueprints/scaffolds, a service catalog, scorecards and SDKs.

POST/api/v1/golden-paths/{id}/adoptAdopt a golden path for a new service.
POST/api/v1/blueprints/{id}/scaffoldsScaffold a service from a blueprint.
POST/api/v1/scorecards/{component}/evaluateEvaluate a component scorecard.
GET/api/v1/catalog/componentsBrowse the service catalog.

API Gateway SS-07

9 operations

API gateway — external route admission, weighted routing, entitlements and webhook providers.

POST/api/v1/admitAdmit an external request against policy.
POST/api/v1/routesRegister an external route.
POST/api/v1/routes/weightsSet weighted traffic split across route versions.
POST/api/v1/entitlementsCheck a caller's entitlements.

Docs SS-33

15 operations

Docs plane — authored docs, review/approve, drift detection, freshness and search.

POST/api/v1/docsAuthor a documentation page.
POST/api/v1/docs/{id}/approveApprove a doc for publish.
POST/api/v1/docs/{id}/driftCheck a doc for drift against its source.
GET/api/v1/searchSearch the docs corpus.

ValueOps SS-59

23 operations

Value operations — product bets, OKRs with check-ins, RICE/WSJF prioritization and ROI.

POST/api/v1/betsCreate a product bet.
POST/api/v1/okrs/{id}/checkinRecord an OKR check-in as immutable evidence.
POST/api/v1/prioritization/scoreScore an item with RICE or WSJF.
POST/api/v1/roi/calculateCalculate platform ROI (net benefit, payback).

FinOps SS-60

25 operations

FinOps — budgets, cost anomalies, allocation rules, waste findings and unit economics.

POST/api/v1/budgetsCreate a budget.
POST/api/v1/anomaliesRaise a cost anomaly.
POST/api/v1/allocation/simulateSimulate a cost-allocation rule.
POST/api/v1/unit-economics/calculateCalculate unit economics for a segment.

Scaffold a service, expose it, watch its cost

Adopt a golden path to scaffold a compliant service, admit its external route through the gateway, and let FinOps watch its cost against a budget.

Adopt a golden pathPOST/api/v1/golden-paths/{id}/adopt

DevPortal scaffolds a service that inherits the platform's guardrails.

Expose itPOST/api/v1/routes

The gateway admits and routes external traffic with entitlements.

Budget itPOST/api/v1/budgets

FinOps sets a budget and watches for anomalies.

Score itPOST/api/v1/scorecards/{component}/evaluate

A scorecard tracks the service's operational maturity.

Where it sits in the platform.

Developer Platform & Marketplace does not reimplement the platform — it composes it. These are the services it leans on and the seams between them.

DevPortal (SS-51)

Golden paths, scaffolds, catalog and scorecards — the developer's front door.

API Gateway (SS-07)

The external admission and routing plane with entitlements.

Docs (SS-33)

Keeps API references fresh, reviewed and drift-checked.

ValueOps (SS-59) + FinOps (SS-60)

Product prioritization and cost governance close the loop.