PUT/api/v1/influencers/:id/ficha

Escrever a ficha estruturada do influencer

Bearer tokenImplementadoescopo manage:influencers

Contrato OpenAPI

operationId: setInfluencerFicha · Implementada

Baixar o contrato OpenAPI 3.1.

Parâmetros

NomeLocalObrigatórioTipo
idpathsimstring

Schema do request

JSON
{
  "additionalProperties": false,
  "properties": {
    "ficha": {
      "$ref": "#/components/schemas/AvatarFicha"
    }
  },
  "required": [
    "ficha"
  ],
  "type": "object"
}

Respostas

HTTPSignificado
200Ficha gravada, já normalizada
defaultErro padronizado

Ver Ficha estruturada do influencer — a narrativa completa (escopo, tetos, brief e exemplos) está lá, porque GET e PUT são o mesmo recurso.

Resumo do PUT:

  • Escopo manage:influencers.
  • Body: { "ficha": { ... } }. Todo campo é opcional.
  • O servidor corta o que passa do teto em vez de recusar, e devolve a ficha já normalizada — é o que ficou gravado.
  • Ficha inteiramente vazia apaga a ficha (grava NULL).
  • brief (texto livre legado) não é tocado.
  • 404 quando o influencer não é do dono do token.