Saltar para o conteúdo principal

​
Páginas de Portfólio do Estudante

Os estudantes podem criar uma página de portfólio público que apresenta certificados selecionados. As páginas de portfólio possuem um slug único (ex.: maria-silva) e podem ser alternadas entre público e privado.

​
O objeto página de portfólio

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-000000000001",
  "slug": "maria-fernanda-silva",
  "is_public": true,
  "bio": "Formada em Ciência da Computação, apaixonada por IA e código aberto.",
  "student": {
    "uuid": "f6a7b8c9-d0e1-2345-fghi-456789012345",
    "name": "Maria Fernanda Silva"
  },
  "items": [
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-000000000002",
      "sort_order": 1,
      "is_visible": true,
      "certificate": {
        "uuid": "a1b2c3d4-...",
        "public_verification_url": "https://verificar.dokstamp.eu/a1b2c3d4"
      }
    }
  ]
}

​
Listar páginas do estudante

GET /students/{student_uuid}/pages

curl "https://api.dokstamp.eu/students/f6a7b8c9-d0e1-2345-fghi-456789012345/pages" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "X-Tenant: {TENANT}"

​
Criar uma página de portfólio

POST /students/{student_uuid}/pages
ParâmetroTipoObrigatórioDescrição
slugstringSimIdentificador único amigável para URL
is_publicbooleanNãoPadrão: false
biostringNãoBiografia do estudante apresentada na página
curl -X POST "https://api.dokstamp.eu/students/f6a7b8c9-d0e1-2345-fghi-456789012345/pages" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{
    "slug": "maria-fernanda-silva",
    "is_public": true,
    "bio": "Formada em Ciência da Computação, apaixonada por IA e código aberto."
  }'

​
Gerir itens da página (certificados)

​
Adicionar um certificado ao portfólio

POST /students/{student_uuid}/pages/{page_uuid}/items
ParâmetroTipoObrigatórioDescrição
certificate_uuidstringSimUUID do certificado a adicionar
sort_orderintegerNãoPosição no portfólio
is_visiblebooleanNãoPadrão: true

​
Listar itens da página

GET /students/{student_uuid}/pages/{page_uuid}/items

​
Atualizar visibilidade ou ordem do item

PATCH /students/{student_uuid}/pages/{page_uuid}/items/{item_uuid}

​
Remover um certificado do portfólio

DELETE /students/{student_uuid}/pages/{page_uuid}/items/{item_uuid}
DELETE /students/{student_uuid}/pages/{page_uuid}/items/batch/destroy

​
Obter, atualizar, eliminar uma página de portfólio

GET    /students/{student_uuid}/pages/{page_uuid}
PATCH  /students/{student_uuid}/pages/{page_uuid}
PUT    /students/{student_uuid}/pages/{page_uuid}
DELETE /students/{student_uuid}/pages