Lista as unidades acadêmicas

Todas as unidades da USP presentes na base, ordenadas por sigla.

GET /academic-units{?search,unit_type} · 1 créditos · Desde a versão 2.0

Parâmetros de consulta

Nome	Tipo	Descrição
`search`	string opcional	Texto contido no nome ou na sigla.
`unit_type`	string opcional	Tipo da unidade. valores aceitos: `standard`, `museum`, `specialized_institute`
`limit`	integer opcional	Quantidade máxima de itens na página. (padrão: `20`) 1–100
`cursor`	string opcional	Cursor opaco devolvido em `_links.next` ou `_links.prev`; não o construa.
`fields`	string[] opcional	Campos de cada item a devolver (lista separada por vírgulas).

Campos da resposta

Nome	Tipo	Descrição
`key`	string	Identificador imutável da unidade. schema.org/identifier
`slug`	string	Segmento público da URL; acompanha a sigla.
`acronym`	string	Sigla de exibição. schema.org/alternateName
`name`	string \| null	Nome por extenso. schema.org/name
`unitType`	string	standard, museum ou specialized_institute. schema.org/additionalType
`singleDepartment`	boolean	A unidade tem um único departamento.
`description`	string \| null	Descrição em HTML sanitizado. schema.org/description
`website`	string \| null	Página oficial. schema.org/url
`director`	string \| null	Direção. schema.org/employee
`address`	string \| null	Endereço. schema.org/address
`contact`	string \| null	Contato. schema.org/contactPoint
`workingHours`	string \| null	Horário de funcionamento. schema.org/openingHours
`isVerified`	boolean	Dados conferidos pela unidade.
`logoUrl`	string \| null	Logotipo. schema.org/logo
`photoUrl`	string \| null	Foto. schema.org/image

Links que a resposta oferece

Nome	Descrição
`uspa:departments`	Departamentos da unidade.

Substitui as rotas legadas: academic-unit

Exemplos de código

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

Resposta

Resposta real da API: GET /academic-units?limit=5

HTTP 200
content-type: application/hal+json
etag: W/"g0-6e2c08bb10a44682"
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

{
  "_embedded": {
    "item": [
      {
        "_links": {
          "collection": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units"
          },
          "self": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cebimar"
          },
          "uspa:departments": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cebimar/departments"
          }
        },
        "acronym": "cebimar",
        "address": null,
        "contact": null,
        "description": "O Centro de Biologia Marinha da USP (CEBIMar) tem origem na Fundação Instituto de Biologia Marinha, criada em 14 de fevereiro de 1955, incorporada à USP em 1…",
        "director": null,
        "isVerified": false,
        "key": "cebimar",
        "logoUrl": null,
        "name": "Centro de Biologia Marinha",
        "photoUrl": null,
        "singleDepartment": true,
        "slug": "cebimar",
        "unitType": "specialized_institute",
        "website": null,
        "workingHours": null
      },
      {
        "_links": {
          "collection": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units"
          },
          "self": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cena"
          },
          "uspa:departments": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cena/departments"
          }
        },
        "acronym": "cena",
        "address": null,
        "contact": null,
        "description": "O Centro de Energia Nuclear na Agricultura (CENA) é um instituto especializado da USP, criado pelo Decreto Estadual nº 46.794, de 22 de setembro de 1966, com…",
        "director": null,
        "isVerified": false,
        "key": "cena",
        "logoUrl": null,
        "name": "Centro de Energia Nuclear na Agricultura",
        "photoUrl": null,
        "singleDepartment": false,
        "slug": "cena",
        "unitType": "specialized_institute",
        "website": null,
        "workingHours": null
      }
    ]
  },
  "_links": {
    "curies": [
      {
        "href": "https://uspaberta.ime.usp.br/api/v2/rels/{rel}",
        "templated": true,
        "name": "uspa"
      }
    ],
    "first": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?limit=5"
    },
    "next": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?cursor=eyJrIjpbIjUiXSwiZiI6ImUzYjBjNDQyOThmYyIsImciOjB9.GxwHBwAlJh7JMpEEo_fAkF&limit=5"
    },
    "self": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?limit=5"
    }
  },
  "count": 5,
  "total": 53,
  "totalIsExact": true
}

USP Aberta · Developers

academic-units

List academic units

Every USP unit in the dataset, ordered by acronym.

GET /academic-units{?search,unit_type} · 1 credits · Since version 2.0

Query parameters

Name	Type	Description
`search`	string optional	Text contained in the name or acronym.
`unit_type`	string optional	Unit type. accepted values: `standard`, `museum`, `specialized_institute`
`limit`	integer optional	Maximum number of items in the page. (default: `20`) 1–100
`cursor`	string optional	Opaque cursor returned in `_links.next` or `_links.prev`; never build one.
`fields`	string[] optional	Item fields to return (comma separated list).

Response fields

Name	Type	Description
`key`	string	Immutable unit identifier. schema.org/identifier
`slug`	string	Public URL segment; follows the acronym.
`acronym`	string	Display acronym. schema.org/alternateName
`name`	string \| null	Full name. schema.org/name
`unitType`	string	standard, museum or specialized_institute. schema.org/additionalType
`singleDepartment`	boolean	The unit has a single department.
`description`	string \| null	Description as sanitized HTML. schema.org/description
`website`	string \| null	Official website. schema.org/url
`director`	string \| null	Head of the unit. schema.org/employee
`address`	string \| null	Address. schema.org/address
`contact`	string \| null	Contact. schema.org/contactPoint
`workingHours`	string \| null	Working hours. schema.org/openingHours
`isVerified`	boolean	Data verified by the unit.
`logoUrl`	string \| null	Logo. schema.org/logo
`photoUrl`	string \| null	Photo. schema.org/image

Links the response offers

Name	Description
`uspa:departments`	The unit's departments.

Replaces legacy routes: academic-unit

Code samples

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

Response

Real response from the API: GET /academic-units?limit=5

HTTP 200
content-type: application/hal+json
etag: W/"g0-058210fce7a79d55"
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

{
  "_embedded": {
    "item": [
      {
        "_links": {
          "collection": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units"
          },
          "self": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cebimar"
          },
          "uspa:departments": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cebimar/departments"
          }
        },
        "acronym": "cebimar",
        "address": null,
        "contact": null,
        "description": "O Centro de Biologia Marinha da USP (CEBIMar) tem origem na Fundação Instituto de Biologia Marinha, criada em 14 de fevereiro de 1955, incorporada à USP em 1…",
        "director": null,
        "isVerified": false,
        "key": "cebimar",
        "logoUrl": null,
        "name": "Centro de Biologia Marinha",
        "photoUrl": null,
        "singleDepartment": true,
        "slug": "cebimar",
        "unitType": "specialized_institute",
        "website": null,
        "workingHours": null
      },
      {
        "_links": {
          "collection": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units"
          },
          "self": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cena"
          },
          "uspa:departments": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cena/departments"
          }
        },
        "acronym": "cena",
        "address": null,
        "contact": null,
        "description": "O Centro de Energia Nuclear na Agricultura (CENA) é um instituto especializado da USP, criado pelo Decreto Estadual nº 46.794, de 22 de setembro de 1966, com…",
        "director": null,
        "isVerified": false,
        "key": "cena",
        "logoUrl": null,
        "name": "Centro de Energia Nuclear na Agricultura",
        "photoUrl": null,
        "singleDepartment": false,
        "slug": "cena",
        "unitType": "specialized_institute",
        "website": null,
        "workingHours": null
      }
    ]
  },
  "_links": {
    "curies": [
      {
        "href": "https://uspaberta.ime.usp.br/api/v2/rels/{rel}",
        "templated": true,
        "name": "uspa"
      }
    ],
    "first": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?limit=5"
    },
    "next": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?cursor=eyJrIjpbIjUiXSwiZiI6ImUzYjBjNDQyOThmYyIsImciOjB9.GxwHBwAlJh7JMpEEo_fAkF&limit=5"
    },
    "self": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?limit=5"
    }
  },
  "count": 5,
  "total": 53,
  "totalIsExact": true
}

USP Aberta · Desarrolladores

academic-units

Lista las unidades académicas

Todas las unidades de la USP presentes en la base, ordenadas por sigla.

GET /academic-units{?search,unit_type} · 1 créditos · Desde la versión 2.0

Parámetros de consulta

Nombre	Tipo	Descripción
`search`	string opcional	Texto contenido en el nombre o en la sigla.
`unit_type`	string opcional	Tipo de unidad. valores aceptados: `standard`, `museum`, `specialized_institute`
`limit`	integer opcional	Número máximo de elementos por página. (predeterminado: `20`) 1–100
`cursor`	string opcional	Cursor opaco devuelto en `_links.next` o `_links.prev`; nunca lo construya.
`fields`	string[] opcional	Campos de cada elemento a devolver (lista separada por comas).

Campos de la respuesta

Nombre	Tipo	Descripción
`key`	string	Identificador inmutable de la unidad. schema.org/identifier
`slug`	string	Segmento público de la URL; sigue a la sigla.
`acronym`	string	Sigla mostrada. schema.org/alternateName
`name`	string \| null	Nombre completo. schema.org/name
`unitType`	string	standard, museum o specialized_institute. schema.org/additionalType
`singleDepartment`	boolean	La unidad tiene un único departamento.
`description`	string \| null	Descripción en HTML saneado. schema.org/description
`website`	string \| null	Sitio web oficial. schema.org/url
`director`	string \| null	Responsable de la unidad. schema.org/employee
`address`	string \| null	Dirección. schema.org/address
`contact`	string \| null	Contacto. schema.org/contactPoint
`workingHours`	string \| null	Horario de atención. schema.org/openingHours
`isVerified`	boolean	Datos verificados por la unidad.
`logoUrl`	string \| null	Logotipo. schema.org/logo
`photoUrl`	string \| null	Foto. schema.org/image

Enlaces que ofrece la respuesta

Nombre	Descripción
`uspa:departments`	Departamentos de la unidad.

Reemplaza rutas heredadas: academic-unit

Ejemplos de código

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

Respuesta

Respuesta real de la API: GET /academic-units?limit=5

HTTP 200
content-type: application/hal+json
etag: W/"g0-e4561666079ffc0e"
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

{
  "_embedded": {
    "item": [
      {
        "_links": {
          "collection": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units"
          },
          "self": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cebimar"
          },
          "uspa:departments": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cebimar/departments"
          }
        },
        "acronym": "cebimar",
        "address": null,
        "contact": null,
        "description": "O Centro de Biologia Marinha da USP (CEBIMar) tem origem na Fundação Instituto de Biologia Marinha, criada em 14 de fevereiro de 1955, incorporada à USP em 1…",
        "director": null,
        "isVerified": false,
        "key": "cebimar",
        "logoUrl": null,
        "name": "Centro de Biologia Marinha",
        "photoUrl": null,
        "singleDepartment": true,
        "slug": "cebimar",
        "unitType": "specialized_institute",
        "website": null,
        "workingHours": null
      },
      {
        "_links": {
          "collection": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units"
          },
          "self": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cena"
          },
          "uspa:departments": {
            "href": "https://uspaberta.ime.usp.br/api/v2/academic-units/cena/departments"
          }
        },
        "acronym": "cena",
        "address": null,
        "contact": null,
        "description": "O Centro de Energia Nuclear na Agricultura (CENA) é um instituto especializado da USP, criado pelo Decreto Estadual nº 46.794, de 22 de setembro de 1966, com…",
        "director": null,
        "isVerified": false,
        "key": "cena",
        "logoUrl": null,
        "name": "Centro de Energia Nuclear na Agricultura",
        "photoUrl": null,
        "singleDepartment": false,
        "slug": "cena",
        "unitType": "specialized_institute",
        "website": null,
        "workingHours": null
      }
    ]
  },
  "_links": {
    "curies": [
      {
        "href": "https://uspaberta.ime.usp.br/api/v2/rels/{rel}",
        "templated": true,
        "name": "uspa"
      }
    ],
    "first": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?limit=5"
    },
    "next": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?cursor=eyJrIjpbIjUiXSwiZiI6ImUzYjBjNDQyOThmYyIsImciOjB9.GxwHBwAlJh7JMpEEo_fAkF&limit=5"
    },
    "self": {
      "href": "https://uspaberta.ime.usp.br/api/v2/academic-units?limit=5"
    }
  },
  "count": 5,
  "total": 53,
  "totalIsExact": true
}