Quarentena do conector

GET

/connectors/{connectorId}/quarantine

curl --request GET \
  --url 'https://api-connect.zoppy.com.br/connectors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/quarantine?status=open&limit=50' \
  --header 'Authorization: Bearer <token>'

• Produção
• Staging

Registros que o conector separou com ctx.quarantine, com o motivo, a versão e quantas vezes voltaram; dados pessoais mascarados. Ficam 30 dias depois da última mudança.

Authorizations

• bearer

Parameters

Path Parameters

connectorId

required

Id do conector

string format: uuid

Id do conector

Query Parameters

status

Situação dos registros

string

default: open

Allowed values: open resolved discarded

Situação dos registros

limit

Quantos registros

integer

default: 50 >= 1 <= 500

Quantos registros

Responses

200

Os registros

Media typeapplication/json

Array<object>

object

id

required

Id do registro na quarentena

string format: uuid

runId

required

Execução que mandou o registro para cá por último

string format: uuid

slice

required

Fatia dessa execução

integer

versionSeq

required

Versão do conector que recusou

integer

object

required

Objeto do registro (campo object do registro); null quando o registro não diz

string

nullable

externalId

required

Id do registro no sistema de origem (externalId ou id do registro), mascarado; null quando não há

string

nullable

httpStatus

required

Status HTTP da recusa, do registro (httpStatus, status, error.status) ou do motivo; null quando não há

integer

nullable

record

required

O registro, com dados pessoais mascarados

reason

required

O motivo dado pelo conector, mascarado

string

attempts

required

Quantas vezes o mesmo registro voltou para a quarentena

integer

status

required

Situação

string

Allowed values: open resolved discarded

correctedAt

required

Quando uma pessoa corrigiu valores

string format: date-time

nullable

reprocessRunId

required

Reprocesso em andamento que levou o registro

string format: uuid

nullable

resolvedByRunId

required

Reprocesso que resolveu o registro

string format: uuid

nullable

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

resolvedAt

required

Quando foi resolvido ou descartado

string format: date-time

nullable

Example

[
  {
    "status": "open"
  }
]

400

Parâmetros inválidos

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

401

Token ausente, inválido ou expirado (connect.unauthorized)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

403

Papel sem acesso ou Connect não liberado (connect.forbidden_role, connect.feature_disabled)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

404

Conector não existe nesta loja (connect.connector_not_found)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}