Edita um modelo

PUT/api/certificates/templates/{id}

Auth: Richiede un token
X-CommunityId: X-CommunityId Invia l’X-CommunityId della community in cui avviene l’operazione.

Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.

Se o modelo já emitiu, `version` sobe; os certificados emitidos guardam a cópia do modelo usado e não mudam. Um modelo ativo que fique sem os campos obrigatórios volta a rascunho.

Parametri

Nome	Dove	Tipo	Descrizione
`id`obbligatorio	path	`string (uuid)`

Header

Nome	Tipo	Descrizione
`X-CommunityId`facoltativo	`string (uuid)`	ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Corpo della richiesta `application/json`

Nome	Tipo	Descrizione
`name`facoltativo	`string`	Nome interno do modelo.
`slug`facoltativo	`string`	Endereço estável do modelo, para outros módulos (gatilhos de curso e evento) apontarem para ele sem o id. Gerado do nome na criação quando não vier; editável; único na comunidade; minúsculas, números e hífens. Renomear o modelo não muda o slug. Inválido ou já usado: 400 com `param: slug`. · max 60
`title`facoltativo	`string`	Título impresso ("Certificado de conclusão").
`description`facoltativo	`string`	Aceita {nome}, {assunto} e {cargaHoraria} ({curso} e {evento} continuam valendo, como apelidos de {assunto}). Trecho entre colchetes é opcional: `concluiu[ {assunto}], com…` some quando a variável dentro dele está vazia. Fora de colchetes, a oração (entre vírgulas) com uma variável vazia é omitida, exceto a primeira, onde só a variável sai.
`workloadHours`facoltativo	`number`
`language`facoltativo	`string`	Nasce com o idioma da comunidade.
`timezone`facoltativo	`string`	Fuso IANA da data impressa.
`signers`facoltativo	`object[]`
`signers[].name`obbligatorio	`string`
`signers[].role`facoltativo	`string`
`signers[].signatureImageUrl`facoltativo	`string`	URL devolvida pelo upload de assinatura.
`layout`facoltativo	`object[]`	Só no tipo IMAGE.
`layout[].key`obbligatorio	`recipientName \| issuedAt \| qr \| title \| description \| workload \| subjectTitle \| code \| signer1 \| signer2`
`layout[].box`obbligatorio	`object`
`layout[].box.x`facoltativo	`number`	≥ 0, ≤ 100
`layout[].box.y`facoltativo	`number`	≥ 0, ≤ 100
`layout[].box.w`facoltativo	`number`	≥ 0.1, ≤ 100
`layout[].box.h`facoltativo	`number`	≥ 0.1, ≤ 100
`layout[].font`facoltativo	`inter \| montserrat \| lora \| playfair-display \| eb-garamond \| great-vibes \| noto-sans`	Obrigatório fora do `qr`.
`layout[].weight`facoltativo	`400 \| 700`
`layout[].size`facoltativo	`number`	% da altura da página (6 ≈ 36 pt).
`layout[].minSize`facoltativo	`number`	O texto encolhe até aqui antes de quebrar em duas linhas.
`layout[].color`facoltativo	`string`
`layout[].align`facoltativo	`left \| center \| right`
`layout[].valign`facoltativo	`top \| middle \| bottom`
`layout[].uppercase`facoltativo	`boolean`

Risposte

Codice	Descrizione
`200`	Operação realizada com sucesso.
`400`	Requisição inválida — falha de validação.
`401`	Token ausente, inválido ou expirado.
`403`	Autenticado, mas sem permissão para esta operação.
`404`	Recurso não encontrado.
`500`	Erro interno do servidor.

Esempio con curl

curl -X PUT "https://api.memberfy.net/api/certificates/templates/<id>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

Parametri

Header

Corpo della richiesta application/json

Risposte

Esempio con curl

Corpo della richiesta `application/json`