SINPRES

Items

Itens (insumos) de um setor. Suporta busca textual em português (full-text search), filtro por unidade de medida e paginação. Cada item possui código, descrição, unidade, normas técnicas, informações gerais e imagem de referência.

Buscar itens de um setor

GET
/api/v1/sectors/{slug}/items

Retorna uma lista paginada de itens (insumos) de um setor.

Busca textual: Use o parâmetro search para buscar por descrição ou informações gerais. A busca utiliza full-text search em português (PostgreSQL tsvector).

Filtro por unidade: Use o parâmetro unit para filtrar por unidade de medida (ex: KG, M, M2, UN).

Paginação: Use page e limit para controlar a paginação. Máximo de 100 itens por página.

Path Parameters

slug*string

Query Parameters

page?integer

Número da página

Default1
Range1 <= value
limit?integer

Itens por página (máx. 100)

Default50
Range1 <= value <= 100
search?string

Termo de busca (full-text search em português)

unit?string

Filtrar por unidade de medida

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/sectors/civil-construction/items"
{
  "data": [
    {
      "id": 0,
      "code": 0,
      "description": "string",
      "unit": "string",
      "technicalStandards": "string",
      "generalInfo": "string",
      "imageUrl": "string",
      "metadata": null,
      "sourceUpdatedAt": "string",
      "createdAt": "string"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "limit": 0,
    "totalPages": 0
  }
}
{
  "error": "string"
}

Detalhar item por código

GET
/api/v1/sectors/{slug}/items/{code}

Retorna os detalhes completos de um item (insumo) pelo seu código de referência. Para Construção Civil, o código corresponde ao código SINAPI.

Path Parameters

slug*string
code?number

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/sectors/civil-construction/items/{code}"
{
  "data": {
    "id": 0,
    "code": 0,
    "description": "string",
    "unit": "string",
    "technicalStandards": "string",
    "generalInfo": "string",
    "imageUrl": "string",
    "metadata": null,
    "sourceUpdatedAt": "string",
    "createdAt": "string"
  }
}
{
  "error": "string"
}