api.devreler.com v2
Internal API gateway — service integration layer

Overview

This host exposes internal REST API endpoints for devreler service integration. It is not intended for direct public use. All requests require a valid Bearer token issued by the authentication service.

Responses are JSON-encoded. Rate limiting and request logging are active on all routes. Access outside of configured service accounts is rejected at the gateway level.

Authentication required for all non-health endpoints. Unauthenticated requests return 401 Unauthorized.

Authentication

MethodDetails
TypeBearer token (JWT)
HeaderAuthorization: Bearer <token>
Expiry3600s, renewable via /auth/refresh
ScopePer-service, defined at token issuance

Service parameters

ParameterValue
ProtocolHTTPS/1.1, HTTP/2
TLSTLS 1.2 / 1.3
Response formatapplication/json
Rate limiting500 req/min per token
Timeout30s per request
StatusOperational

Endpoints

GET/health
Returns service health status. No authentication required.
POST/auth/token
Issues a JWT token for the provided service credentials.
POST/auth/refresh
Refreshes an existing non-expired token. Returns new token with reset expiry.
GET/v2/services
Returns list of registered services and their current availability status.
POST/v2/events
Publishes an event to the internal message bus. Requires events:write scope.
GET/v2/config/{service}
Returns runtime configuration for the specified service. Requires config:read scope.
DELETE/v2/sessions/{id}
Invalidates an active session by ID. Requires sessions:write scope.

Error codes

CodeMeaning
400Malformed request body or missing required field
401Missing or invalid Bearer token
403Token lacks required scope for this endpoint
404Resource not found
429Rate limit exceeded
503Upstream service temporarily unavailable