Developer Documentation • API v1.4
Quickstart & Wire Protocol Specification
Integrate NexusGrid into your production microservices using standard HTTP/2, gRPC, or WebSockets.
1. Provision API Key
Generate a scoped Ed25519 workload token via the CLI (`nexusctl auth token create --ttl 720h`) with namespace-level RBAC policies.
2. Configure TLS 1.3 Mutual Auth
All control-plane and data-plane endpoints enforce strict ALPN `h2` negotiation and ECDHE-ECDSA cipher suites.
3. Stream Batch Embeddings
Use multiplexed bidirectional streams to ingest up to 50,000 vectors per second per worker node.
HTTP/2 REST Endpoint Specification
POST /v1/namespaces/{ns}/query
curl -X POST https://dadaguai9523.xyz/v1/namespaces/production/query \
-H "Authorization: Bearer ng_live_98a7bc65e4d3f210" \
-H "Content-Type: application/json" \
-d '{
"vector": [0.0142, -0.0831, 0.2219, 0.0045],
"topK": 10,
"filter": {"region": {"$eq": "us-west"}},
"includeMetadata": true
}'