Escritas em outros sistemas

GET

/connectors/{connectorId}/external-writes

curl --request GET \
  --url https://api-connect.zoppy.com.br/connectors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/external-writes \
  --header 'Authorization: Bearer <token>'

• Produção
• Staging

Se o conector escreve fora, em quais sistemas as escritas já saem sem perguntar e as escritas guardadas esperando a confirmação de uma pessoa, exatamente como sairiam (segredos como marcadores).

Authorizations

• bearer

Parameters

Path Parameters

connectorId

required

Id do conector

string format: uuid

Id do conector

Responses

200

Escritas do conector

Media typeapplication/json

object

externalWrites

required

Se a versão publicada (ou a mais nova, antes de publicar) escreve fora

boolean

confirmedHosts

required

Sistemas em que as escritas já saem sem perguntar

Array<string>

needsConfirmation

required

Há escrita esperando uma pessoa confirmar

boolean

heldWrites

required

Escritas guardadas, da mais nova para a mais antiga

Array<object>

object

id

required

string format: uuid

runId

required

Execução que guardou a escrita

string format: uuid

versionSeq

required

Versão do conector que pediu a escrita

integer

host

required

Sistema que recebe a escrita

string

status

required

Held espera a pessoa; confirmed ainda não saiu; sending saindo; sent saiu; failed pode ter chegado e nunca é repetida; discarded não sai mais

string

Allowed values: held confirmed sending sent failed discarded

method

required

string

url

required

Como o código pediu; segredos aparecem como marcadores

string

query

required

object

key

additional properties

string

headers

required

object

key

additional properties

string

body

required

Corpo com dados pessoais mascarados

string

nullable

heldAt

required

Instante ISO 8601

string format: date-time

confirmedAt

required

Instante ISO 8601

string format: date-time

nullable

confirmedByUserId

required

string

nullable

sentAt

required

Instante ISO 8601

string format: date-time

nullable

responseStatus

required

Status HTTP que o outro sistema respondeu

integer

nullable

failureCode

required

string

nullable

notice

required

Aviso para a pessoa quando a escrita pode ter chegado ao outro sistema

string

nullable

notice

required

O que vai para o outro sistema não tem desfazer

string

Example

{
  "heldWrites": [
    {
      "status": "held"
    }
  ]
}

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 ou escrita guardada de outra loja ou inexistente (connect.connector_not_found, connect.held_write_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"
  }
}