API: Phoenix railing proxy, API key auth for /api/v1/*, schema export, docs, migrations, tests

- Phoenix API Railing: proxy to PHOENIX_RAILING_URL, tenant me routes
- Tenant-auth: X-API-Key support for /api/v1/* (api_keys table)
- Migration 026: api_keys table; 025 sovereign stack marketplace
- GET /graphql/schema, GET /graphql-playground, api/docs OpenAPI
- Integration tests: phoenix-railing.test.ts
- docs/api/API_VERSIONING: /api/v1/ railing alignment
- docs/phoenix/PORTAL_RAILING_WIRING

Made-with: Cursor
This commit is contained in:
defiQUG
2026-03-11 12:57:41 -07:00
parent 33b02b636b
commit 8436e22f4c
45 changed files with 4308 additions and 17 deletions

5
api/docs/README.md Normal file
View File

@@ -0,0 +1,5 @@
# Phoenix API — API docs
- **GraphQL:** `POST /graphql`. Schema: `GET /graphql/schema`. Interactive: `GET /graphql-playground`.
- **OpenAPI (GraphQL):** [openapi-graphql.yaml](./openapi-graphql.yaml)
- **REST railing (Infra/VE/Health, tenant me):** Same paths as Phoenix Deploy API; when `PHOENIX_RAILING_URL` is set, Sankofa API proxies to it. Full OpenAPI for the railing is in the `phoenix-deploy-api` repo (`openapi.yaml`). Tenant-scoped: `GET /api/v1/tenants/me/resources`, `GET /api/v1/tenants/me/health` (require JWT or X-API-Key with tenant).