Pular para o conteúdo
Zoppy ConnectZoppy ConnectZoppy Connect

Aceitar os termos

POST
/connect/terms
curl --request POST \
  --url https://api-connect.zoppy.com.br/connect/terms \
  --header 'Authorization: Bearer <token>'

Registra que um MASTER aceitou a versão atual dos termos do Zoppy Connect pela loja (quem, loja, versão e quando). Repetir não muda nada e devolve o primeiro aceite. Antes do aceite, as outras rotas do Connect respondem 403 connect.terms_not_accepted.

Authorizations

Seção intitulada “Authorizations”

Responses

Seção intitulada “Responses”

200

Seção intitulada “200”

Aceite registrado

Media typeapplication/json
object
version
required

Versão dos termos aceita

string
termsAcceptedAt
required

Quando a loja aceitou essa versão; repetir o aceite devolve o primeiro instante

string format: date-time
termsAcceptedBy
required

Id na Zoppy do MASTER que aceitou essa versão pela loja

string

Example generated

{
  "version": "example",
  "termsAcceptedAt": "2026-04-15T12:00:00Z",
  "termsAcceptedBy": "example"
}

401

Seção intitulada “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

Seção intitulada “403”

Token restrito, sem loja, papel sem acesso, usuário que não é MASTER ou Connect não liberado (connect.forbidden_role, connect.terms_master_only, 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"
  }
}