Substituir certificado por externo
Permite que o produtor substitua o certificado do aluno por um certificado externo já emitido.
Required scopes:alpaclass_enrollment_write
POST
https://api.eduzz.com/alpaclass/v1/producer/teams/:teamSlug/enrollments/:enrollmentId/certificate
Processamento assíncrono
Esta requisição é processada de forma assíncrona. Ao enviar a URL do certificado, o sistema irá validar e processar o arquivo em background.
Em caso de falha no processamento, será disparado o webhook certificate_import_failed. Consulte a documentação do webhook para mais detalhes.
Regras de validação da URL
A URL do certificado deve seguir as seguintes regras:
- Protocolo HTTPS obrigatório: A URL deve utilizar o protocolo
https:// - Métodos GET e HEAD disponíveis: O servidor que hospeda o arquivo deve responder aos métodos HTTP GET e HEAD, pois utilizamos HEAD para validar o arquivo antes do download
- Arquivo PDF válido: O arquivo deve ser um PDF válido com a extensão
.pdf - Tamanho máximo: O arquivo não pode exceder 20MB
O sistema irá verificar essas condições antes de processar o certificado. Se alguma validação falhar, o webhook de falha será disparado com a mensagem de erro correspondente.
Path params
teamSlug
Slug da escola
enrollmentId
Id da matrícula
Body params
url
string
URL do arquivo PDF do certificado externo emitido pelo produtor
Status codes
| Status | Descrição |
| 204 | Success |
Exemplos
1curl --request POST \
2 --url 'https://api.eduzz.com/alpaclass/v1/producer/teams/minha-escola/enrollments/27000255/certificate' \
3 --header 'Accept: application/json' \
4 --data '
5{
6 "url": "https://example.com/certificate.pdf"
7}
8'Response
1null