Connect API

Connect API Reference - Operator API

Authentication Specification

Overview

Implement an authentication mechanism using clientKey and clientSecret to obtain a valid JWT token.

Requirements

• Credentials:

  • clientKey: A unique identifier for the client.

  • clientSecret: A secret associated with the clientKey used for verification.

  Security Considerations

  • Ensure clientSecret is stored securely and transmitted over HTTPS.

  • Implement rate limiting to protect against brute force attacks.

---

Authenticates the client using the provided credentials.

post

This endpoint is used to authenticate clients by validating their credentials (key and secret). On success, an access token and a refresh token are returned. These tokens are used for authorized access to the protected API endpoints.

Authorizations

Bearer

AuthorizationstringRequired

REQUIRED - JWT Authorization header using the Bearer scheme. All API endpoints require authentication, except for authentication endpoints (Connect/authentication). Example: "Authorization: Bearer {token}"

Query parameters

api-versionstringOptional

Body

application/jsontext/jsonapplication/*+json

clientKeystring · nullableOptional

clientSecretstring · nullableOptional

Responses

200

Authentication was successful. The response includes the access and refresh tokens.

text/plainapplication/jsontext/json

accessTokenstring · nullableOptional

refreshTokenstring · nullableOptional

expiresIninteger · int64 · nullableOptional

validFromstring · date-timeOptional

validTostring · date-timeOptional

400

If the credentials are invalid or the request is malformed.

text/plainapplication/jsontext/json

post

/Connect/authentication

HTTPcURLJavaScriptPython

POST /Connect/authentication HTTP/1.1
Host: operator-api.mgm.bingaodobrasil.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "clientKey": "text",
  "clientSecret": "text"
}

application/jsontext/jsonapplication/*+json

{
  "accessToken": "text",
  "refreshToken": "text",
  "expiresIn": 1,
  "validFrom": "2026-03-02T02:43:24.835Z",
  "validTo": "2026-03-02T02:43:24.835Z"
}