Pular para o conteúdo

Reaproveitar o acesso

POST
/connectors/{connectorId}/secret-reuse
curl --request POST \
--url https://api-connect.zoppy.com.br/connectors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/secret-reuse \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "fromConnectorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

O sim da pessoa: copia, cifrados, os segredos que este conector pede e ainda não tem a partir de outro conector da loja do mesmo sistema. A IA só pede; quem reaproveita é a pessoa.

connectorId
required

Id do conector

string format: uuid

Id do conector

Media typeapplication/json
object
fromConnectorId
required

O conector da mesma loja e do mesmo sistema de onde vêm os segredos

string format: uuid

Example generated

{
"fromConnectorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Segredos reaproveitados

Media typeapplication/json
object
reused
required

Segredos copiados, cifrados, do outro conector; o valor nunca passa pelo chat

Array<string>

Example generated

{
"reused": [
"example"
]
}

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"
}
}

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"
}
}

Conector de outra loja ou inexistente (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"
}
}

Outro sistema ou nada a reaproveitar (connect.secret_reuse_refused, reason not_same_system ou nothing_to_reuse)

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"
}
}