APPLICATION PROGRAMMING INTERFACES (APIs)

Introduction

This page provides a description of the external interfaces exposed by the APP server for use by third party systems.

Server services are available in JSON format.

 

Which APP services are available?

The following services are available for external systems:

  • articles;
  • events;
  • surveys.

 

ARTICLES

This service provides the list of articles referred to each country.

It is available under the following location:
https://services.prodemo-europa.eu/api/v1/:country/:locale/articles?page=1

HEADERS
Content-Type: application/json
Accept: application/json

PARAMS
page: number of page

PATH VARIABLES
country: reference country
locale: reference language

Response sample

[
  {
    “id”: 39,
    “date”: “2021-02-19T07:00:00.000Z”,
    “image_url”: “https://services.prodemo-europa.eu/uploads/article/image/39/mobile_citizens.png”,
    “title”: “Mobile citizens in Italy”,
    “abstract”: “Integration of foreign residents in the life of local communities”,
    “description”: “\u003cp\u003eIn 1994, Italy ratified the Convention on the Participation of Foreigners in Public Life at Local Level, which aimed to improve the integration of foreign   residents into the life of local communities. The Convention allows signatory States to commit themselves to granting the right to vote and stand for election in local elections to foreigners who have been legally and habitually resident in the State in question for at least five years.\u003cbr /\u003e\r\nIn Italy, the Convention has been ratified with the exception of Chapter C concerning the right to vote in municipal elections. However, with regard to the Italian situation it is necessary to make a distinction on the electoral rights of resident foreigners between third-country nationals and EU citizens.\u0026nbsp;\u003cbr /\u003e\r\nIf, on the one hand, third-country nationals do not enjoy any electoral rights in all elections regulated by Italian national and local laws, on the other hand EU citizens enjoy full electoral rights, both active and passive, in municipal and European Parliament elections thanks to Law no. 52 of 6 February 1996 and Decree-Law no. 197 of 12 April 1996.\u003c/p\u003e\r\n”,
    “created_by_type”: “AdminUser”
  }
]

EVENTS

This service provides the list of events referred to each country.

It is available under the following location:
https://services.prodemo-europa.eu/api/v1/:country/:locale/events

HEADERS
Content-Type: application/json
Accept: application/json

PATH VARIABLES
country: reference country
locale: reference language (if available)

Response sample

[
  {
    “id”: 46,
    “link”: “https://zoom.us/j/98422711858?pwd=Q2kxRDB2QlRxeS92a2dOU2laRmJ0UT09”,
    “address”: “Roma, Italia”,
    “latitude”: “41.9027835”,
    “longitude”: “12.4963655”,
    “date”: “2021-03-22T13:00:00.000Z”,
    “event_type”: {
      “id”: 9,
      “created_at”: “2021-03-15T13:20:04.000Z”,
      “updated_at”: “2021-03-15T13:20:04.000Z”,
      “name”: “Workshop”
    },
    “title”: “Political participation and civic engagement of mobile EU citizens and non-EU citizens”,
    “abstract”: “Workshop”,
    “description”: “\u003cp\u003e2: 00pm\u003cbr /\u003e\r\nWelcome greetings\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n2:10 pm\u003cbr /\u003e\r\nThe PRODEMO project: Promoting democratic engagement through mobile participation: main objectives and project products\u003cbr /\u003e\r\nCostanza Raguso, Project manager – Integra programme\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n2:30 pm\u003cbr /\u003e\r\nEU citizens living in another Member State\u003cbr /\u003e\r\nValentina Fabbri, President of Programma integra\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n2:45 pm\u003cbr /\u003e\r\nOrigins and basic features of the concept of European citizenship\u003cbr /\u003e\r\nStefano Milia, Executive Director CEP – European Policy Centre\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n3:15 pm\u003cbr /\u003e\r\nThe right to mobility within the EU territory, the so called \u0026quot;European citizenship\u0026quot; and related rights\u0026quot;.\u003cbr /\u003e\r\nLoredana Leo – lawyer at the Court of Rome\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n4:00 pm – 4:15 pm Break\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n4:15 pm\u003cbr /\u003e\r\nThe right to mobility within the EU territory, the so called \u0026quot;European citizenship\u0026quot; and related rights\u0026quot;.\u003cbr /\u003e\r\nLoredana Leo – lawyer at the Court of Rome\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n5:00 pm\u003cbr /\u003e\r\nYour Europe – presentation of the Portal\u003cbr /\u003e\r\nNicoletta Basili, Head of the Research and Development Area – Integra Programme\u003cbr /\u003e\r\n\u0026nbsp;\u003cbr /\u003e\r\n5:15 pm\u003cbr /\u003e\r\nDebate\u003c/p\u003e\r\n”,
    “created_by_type”: “AdminUser”,
    “approved”: true,
    “approved_or_rejected_at”: “2021-03-26T12:25:55.000Z”,
    “approved_or_rejected_message”: null,
    “created_by_name”: “PRODEMO”
  }
]

SURVEYS

This service provides the list of surverys referred to each country.

It is available under the following location:
https://services.prodemo-europa.eu/api/v1/:country/:locale/surveys?page=1

HEADERS
Content-Type: application/json
Accept: application/json

PARAMS
page: number of page

PATH VARIABLES
country: reference country
locale: reference language (if available)