Seções da Calibração

GET

/v1/calibration

const url = 'https://developers.nexo.winningsales.com.br/v1/calibration';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://developers.nexo.winningsales.com.br/v1/calibration \
  --header 'Authorization: Bearer <token>'

Cada seção da Calibração (Forecast, Perfil de cliente, Motivos de perda e as que vierem), o que ela decide, se a empresa mudou algo do padrão e a última mudança, com quem fez e por onde (app, api, mcp). Só administradores, como a tela Calibração; o papel é relido a cada chamada, e para mudar o token precisa do escopo calibration:write.

Authorizations

bearer

Responses

200

As seções, na ordem da tela

application/json

object

data

required

As seções da Calibração, na ordem da tela

Array<object>

object

section

required

Nome estável da seção, usado nas rotas e nas ferramentas

string

title

required

Nome do subitem na tela Calibração

string

description

required

O que a seção decide

string

calibrated

required

True quando algum valor difere do padrão

boolean

lastChange

required

A última mudança, ou null quando a seção nunca foi calibrada

object

changedAt

required

Quando a mudança foi salva

string format: date-time

changedByUserId

required

Quem salvou

string format: uuid

nullable

changedByName

required

Nome de quem salvou

string

nullable

surface

required

Where the change was made: app (the Calibração screen), api (public REST /v1), cli or mcp (the hosted MCP)

string

Allowed values: app api cli mcp

changed

required

Grupos ou limites que esta mudança moveu, contra os valores em vigor antes dela

Array<string>

Example

{
  "data": [
    {
      "lastChange": {
        "surface": "app"
      }
    }
  ]
}

401

Token ausente, inválido, expirado ou revogado

application/json

object

type

required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string

title

required

Error class name

string

status

required

HTTP status code

integer

detail

required

Human-readable message, safe to display to end users

string

requestId

required

Correlation id — send it to support to locate the full trail

string

nullable

meta

Structured details safe for the frontend (field errors, ids)

object

key

additional properties

Example

{
  "type": "public_api.invalid_credential",
  "title": "InvalidCredentialError",
  "status": 401,
  "detail": "Token de acesso inválido, expirado ou revogado. Crie um novo token de acesso no Nexo.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb"
}

403

Papel, escopo do token ou plano não permitem a operação

application/json

object

type

required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string

title

required

Error class name

string

status

required

HTTP status code

integer

detail

required

Human-readable message, safe to display to end users

string

requestId

required

Correlation id — send it to support to locate the full trail

string

nullable

meta

Structured details safe for the frontend (field errors, ids)

object

key

additional properties

Example

{
  "type": "public_api.insufficient_scope",
  "title": "InsufficientScopeError",
  "status": 403,
  "detail": "Este token não tem o escopo conversations:read, exigido por esta operação. Gere um token com esse escopo.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "operation": "conversations.reading",
    "scope": "conversations:read"
  }
}

429

Limite de chamadas da empresa ou do token atingido

application/json

object

type

required

Stable machine-readable error code (e.g. identity.email_already_in_use)

string

title

required

Error class name

string

status

required

HTTP status code

integer

detail

required

Human-readable message, safe to display to end users

string

requestId

required

Correlation id — send it to support to locate the full trail

string

nullable

meta

Structured details safe for the frontend (field errors, ids)

object

key

additional properties

Example

{
  "type": "public_api.rate_limited",
  "title": "PublicRateLimitedError",
  "status": 429,
  "detail": "Muitas chamadas em pouco tempo. Tente de novo em 12 segundos.",
  "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb",
  "meta": {
    "class": "content",
    "limitedBy": "company",
    "limit": 120,
    "windowSeconds": 60,
    "retryAfterSeconds": 12
  }
}