Obtém um departamento

Detalhe de um departamento, inclusive arquivado. Referências não canônicas respondem 308.

GET /academic-units/{unit_key}/departments/{department_key} · 1 créditos · Desde a versão 2.0

Variáveis de caminho

Nome	Tipo	Descrição
`unit_key`	string obrigatório	Identificador da unidade: slug atual, slug antigo, chave, sigla ou id.
`department_key`	string obrigatório	Identificador do departamento dentro da unidade.

Campos da resposta

Nome	Tipo	Descrição
`key`	string	Identificador imutável dentro da unidade. schema.org/identifier
`slug`	string	Segmento público da URL.
`acronym`	string	Sigla de exibição. schema.org/alternateName
`name`	string \| null	Nome por extenso. schema.org/name
`description`	string \| null	Descrição em HTML sanitizado. schema.org/description
`director`	string \| null	Chefia. schema.org/employee
`viceDirector`	string \| null	Vice-chefia. schema.org/employee
`archivedAt`	datetime \| null	Quando foi arquivado; nulo se ativo.
`facultyCount`	integer	Docentes distintos vinculados. schema.org/numberOfEmployees
`academicUnitKey`	string	Chave da unidade a que pertence. schema.org/parentOrganization
`academicUnitAcronym`	string	Sigla da unidade a que pertence.

Links que a resposta oferece

Nome	Descrição
`up`	Unidade a que pertence.

Substitui as rotas legadas: department-by-unit-and-ref

Exemplos de código

curl -s 'https://uspaberta.ime.usp.br/api/v2/academic-units/ime/departments/mac' \
  -H 'Authorization: Bearer '"$USPA_API_KEY" \
  -H 'Accept: application/hal+json'

Resposta

Resposta real da API: GET /academic-units/ime/departments/mac

HTTP 200
content-type: application/hal+json
etag: W/"g0-94c1aa14eafe03ea"
cache-control: private, max-age=300, must-revalidate
content-language: pt-BR
vary: Accept, Accept-Language
ratelimit-policy: "daily";q=4000;w=86400, "burst";q=60;w=60
uspa-credit-cost: 1

{
  "_links": {
    "curies": [
      {
        "href": "https://uspaberta.ime.usp.br/api/v2/rels/{rel}",
        "templated": true,
        "name": "uspa"
      }
    ],
    "self": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/ime/departments/mac"
    },
    "up": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/ime"
    }
  },
  "academicUnitAcronym": "ime",
  "academicUnitKey": "ime",
  "acronym": "mac",
  "archivedAt": null,
  "description": null,
  "director": null,
  "facultyCount": 37,
  "key": "mac",
  "name": "Departamento de Ciência da Computação",
  "slug": "mac",
  "viceDirector": null
}

USP Aberta · Developers

unit-department

Get a department

Details of a department, archived included. Non-canonical references answer 308.

GET /academic-units/{unit_key}/departments/{department_key} · 1 credits · Since version 2.0

Path variables

Name	Type	Description
`unit_key`	string required	Unit identifier: current slug, old slug, key, acronym or id.
`department_key`	string required	Department identifier inside the unit.

Response fields

Name	Type	Description
`key`	string	Immutable identifier inside the unit. schema.org/identifier
`slug`	string	Public URL segment.
`acronym`	string	Display acronym. schema.org/alternateName
`name`	string \| null	Full name. schema.org/name
`description`	string \| null	Description as sanitized HTML. schema.org/description
`director`	string \| null	Head of department. schema.org/employee
`viceDirector`	string \| null	Deputy head. schema.org/employee
`archivedAt`	datetime \| null	When it was archived; null if active.
`facultyCount`	integer	Distinct linked faculty members. schema.org/numberOfEmployees
`academicUnitKey`	string	Key of the owning unit. schema.org/parentOrganization
`academicUnitAcronym`	string	Acronym of the owning unit.

Links the response offers

Name	Description
`up`	The owning unit.

Replaces legacy routes: department-by-unit-and-ref

Code samples

curl -s 'https://uspaberta.ime.usp.br/api/v2/academic-units/ime/departments/mac' \
  -H 'Authorization: Bearer '"$USPA_API_KEY" \
  -H 'Accept: application/hal+json'

Response

Real response from the API: GET /academic-units/ime/departments/mac

HTTP 200
content-type: application/hal+json
etag: W/"g0-c01c537568fc0671"
cache-control: private, max-age=300, must-revalidate
content-language: en
vary: Accept, Accept-Language
ratelimit-policy: "daily";q=4000;w=86400, "burst";q=60;w=60
uspa-credit-cost: 1

{
  "_links": {
    "curies": [
      {
        "href": "https://uspaberta.ime.usp.br/api/v2/rels/{rel}",
        "templated": true,
        "name": "uspa"
      }
    ],
    "self": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/ime/departments/mac"
    },
    "up": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/ime"
    }
  },
  "academicUnitAcronym": "ime",
  "academicUnitKey": "ime",
  "acronym": "mac",
  "archivedAt": null,
  "description": null,
  "director": null,
  "facultyCount": 37,
  "key": "mac",
  "name": "Departamento de Ciência da Computação",
  "slug": "mac",
  "viceDirector": null
}

USP Aberta · Desarrolladores

unit-department

Obtiene un departamento

Detalles de un departamento, incluidos los archivados. Las referencias no canónicas responden 308.

GET /academic-units/{unit_key}/departments/{department_key} · 1 créditos · Desde la versión 2.0

Variables de ruta

Nombre	Tipo	Descripción
`unit_key`	string obligatorio	Identificador de la unidad: slug actual, slug anterior, clave, sigla o id.
`department_key`	string obligatorio	Identificador del departamento dentro de la unidad.

Campos de la respuesta

Nombre	Tipo	Descripción
`key`	string	Identificador inmutable dentro de la unidad. schema.org/identifier
`slug`	string	Segmento público de la URL.
`acronym`	string	Sigla mostrada. schema.org/alternateName
`name`	string \| null	Nombre completo. schema.org/name
`description`	string \| null	Descripción en HTML saneado. schema.org/description
`director`	string \| null	Jefe del departamento. schema.org/employee
`viceDirector`	string \| null	Subjefe. schema.org/employee
`archivedAt`	datetime \| null	Fecha de archivo; null si está activo.
`facultyCount`	integer	Docentes distintos vinculados. schema.org/numberOfEmployees
`academicUnitKey`	string	Clave de la unidad propietaria. schema.org/parentOrganization
`academicUnitAcronym`	string	Sigla de la unidad propietaria.

Enlaces que ofrece la respuesta

Nombre	Descripción
`up`	La unidad propietaria.

Reemplaza rutas heredadas: department-by-unit-and-ref

Ejemplos de código

curl -s 'https://uspaberta.ime.usp.br/api/v2/academic-units/ime/departments/mac' \
  -H 'Authorization: Bearer '"$USPA_API_KEY" \
  -H 'Accept: application/hal+json'

Respuesta

Respuesta real de la API: GET /academic-units/ime/departments/mac

HTTP 200
content-type: application/hal+json
etag: W/"g0-3eb1d2a24d1087a6"
cache-control: private, max-age=300, must-revalidate
content-language: es
vary: Accept, Accept-Language
ratelimit-policy: "daily";q=4000;w=86400, "burst";q=60;w=60
uspa-credit-cost: 1

{
  "_links": {
    "curies": [
      {
        "href": "https://uspaberta.ime.usp.br/api/v2/rels/{rel}",
        "templated": true,
        "name": "uspa"
      }
    ],
    "self": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/ime/departments/mac"
    },
    "up": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/ime"
    }
  },
  "academicUnitAcronym": "ime",
  "academicUnitKey": "ime",
  "acronym": "mac",
  "archivedAt": null,
  "description": null,
  "director": null,
  "facultyCount": 37,
  "key": "mac",
  "name": "Departamento de Ciência da Computação",
  "slug": "mac",
  "viceDirector": null
}