Embat Authentication API
`Authentication` provides the credentials Embat issues to access the rest of the public API. Every other endpoint requires a JWT `idToken` in the `Authorization: Bearer ` header; requests with no token, or with an invalid or expired one, are rejected with `401`.An `email`/`password` pair identifies a service user with access to a group of companies in Embat. Keep these credentials secret: never commit them to a repository, embed them in client-side code, or expose them in publicly accessible logs.**Typical flow:**1. Exchange your `email`/`password` for a bearer token:```jsonPOST /authentication/token{ "email": "erp-integration@acme-corp.com", "password": "your-service-password"}```which returns:```json{ "idToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE5YzY4In0..." }```2. Send that token as `Authorization: Bearer ` on every subsequent request.3. The token expires **60 minutes** after issuance. Call `/authentication/token` again with the same credentials to get a new one; there is no separate refresh endpoint.4. Accounts with multi-factor authentication enabled cannot authenticate through this endpoint.5. If `email` or `password` is missing or malformed, the validation error response never echoes back the submitted values, so credentials are never reflected in error output.All requests must be made over **HTTPS**.
Embat Authentication API is one of 22 APIs that Embat publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 1 operation across 1 path, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version 2.120.3.
Requests are made against the base URL https://api.embat.io.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Embat Authentication API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (HTTPBearer).
Paths & Operations 1
Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.
Authentication provides the credentials Embat issues to access the rest of the public API. Every other endpoint requires a JWT idToken in the Authorization: Bearer header; request…
Schemas 5
The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are ValidationError (5 properties), PostAuthenticationRequestSchema (2 properties), HTTPValidationError (1 property), ErrorResponse (1 property). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Embat 12
Other APIs Embat publishes across the network.