[App Municipal] Events

Organização: Município da Guarda

Tema: Governação

Licença: Creative Commons Attribution 4.0 International

Status: Approved

Última atualização:

Descrição:

API para disponibilização estruturada da agenda de eventos da autarquia, abrangendo iniciativas culturais, institucionais, sociais e desportivas, garantindo acesso rápido e normalizado para integração com portais e aplicações.

A API fornece dados em formato JSON, permitindo que sistemas consultem informação atualizada sobre eventos programados, com suporte para pesquisa por categoria, data e localização.

Funcionalidades principais:

Consulta de eventos por categoria (Cultura, Institucional, Social, Desporto, Educação, Turismo).
Metadados completos: título, descrição, data/hora, local, coordenadas GPS, organizador e link para detalhes.
Respostas otimizadas para integração com calendários, mapas e dashboards.

Benefícios:

Informação centralizada e atualizada sobre a agenda municipal.
Apoio à divulgação cultural e à participação cidadã.
Integração simplificada com portais, aplicações móveis e sistemas internos.

Endpoints

Nome	URL	Método
Endpoint V1.0	https://od.mun-guarda.pt/api/appmunicipal/agenda	GET

Schemas

Schema URL

https://od.mun-guarda.pt/files/schemas/2025/schema_20251220152910.json

Schema Media Type

application/schema+json

Schema JSON

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "",
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "data": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "items": {
        "required": [
          "id",
          "status",
          "featured",
          "title",
          "adress",
          "website",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "number"
          },
          "status": {
            "type": "string",
            "minLength": 1
          },
          "featured": {
            "type": "boolean"
          },
          "title": {
            "type": "string",
            "minLength": 1
          },
          "category": {
            "type": "array",
            "uniqueItems": true,
            "minItems": 1,
            "items": {
              "required": [
                "id",
                "title"
              ],
              "properties": {
                "id": {
                  "type": "number"
                },
                "title": {
                  "type": "string",
                  "minLength": 1
                }
              }
            }
          },
          "image": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "minLength": 1
              },
              "alt": {
                "type": "string",
                "minLength": 1
              },
              "r1200x630": {
                "type": "string",
                "minLength": 1
              },
              "r1240x700": {
                "type": "string",
                "minLength": 1
              },
              "r1280Y": {
                "type": "string",
                "minLength": 1
              },
              "r395x375": {
                "type": "string",
                "minLength": 1
              },
              "thumb": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "url",
              "alt",
              "r1200x630",
              "r1240x700",
              "r1280Y",
              "r395x375",
              "thumb"
            ]
          },
          "date": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "minLength": 1
              },
              "range": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "string",
                    "minLength": 1
                  },
                  "end": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": [
                  "start",
                  "end"
                ]
              }
            },
            "required": [
              "mode",
              "range"
            ]
          },
          "adress": {
            "type": "string",
            "minLength": 1
          },
          "website": {
            "type": "string",
            "minLength": 1
          },
          "content": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "minLength": 1
              },
              "setup": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": [
                  "text"
                ]
              }
            },
            "required": [
              "type",
              "setup"
            ]
          },
          "created_at": {
            "type": "string",
            "minLength": 1
          },
          "updated_at": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    }
  },
  "required": [
    "success",
    "data"
  ]
}

Ficheiros

Nome	Formato	Tamanho

Versão Atual

Status do Schema: Approved
Última Atualização:
Versão Atual: 1