Edison Next Panorama - Integration API (0.9.8)

Download OpenAPI specification:

API standard di integrazione di Edison Next Panorama con sistemi esterni

Data Source

operations for data sources

Restituisce le fonti dati disponibili

Authorizations:
panorama_consumer_api_key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Aggiunge una Fonte Dati (admin only)

Authorizations:
panorama_administrator_api_key
Request Body schema: application/json
required
id
required
string <uri>

ID univoco della Fonte Dati

name
required
string

Nome canonico della Fonte Dati

organization
required
string

Organizzazione di riferimento (ovvero soggetto alimentante) per la Fonte Dati

processor
string

Organizzazione che gestisce tecnicamente la Fonte Dati

Responses

Request samples

Content type
application/json
{
  • "id": "fvg_ispfor_tsgo",
  • "name": "Ministero per i Beni e le Attività Culturali",
  • "organization": "Ministero per i Beni e le Attività Culturali",
  • "processor": "Insiel S.p.A."
}

Modifica una sorgente dati esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string
Request Body schema: application/json
required
id
required
string <uri>

ID univoco della Fonte Dati

name
required
string

Nome canonico della Fonte Dati

organization
required
string

Organizzazione di riferimento (ovvero soggetto alimentante) per la Fonte Dati

processor
string

Organizzazione che gestisce tecnicamente la Fonte Dati

Responses

Request samples

Content type
application/json
{
  • "id": "fvg_ispfor_tsgo",
  • "name": "Ministero per i Beni e le Attività Culturali",
  • "organization": "Ministero per i Beni e le Attività Culturali",
  • "processor": "Insiel S.p.A."
}

Elimina una sorgente dati (vuota) esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string

Responses

Type

operations for data types

Restituisce i Tipi di Entità definiti

Authorizations:
panorama_consumer_api_key

Responses

Response samples

Content type
application/json
[]

Crea un nuovo Tipo di Entità (admin only)

Authorizations:
panorama_administrator_api_key
Request Body schema: application/json
required
id
required
string <uri>

Identificativo univoco del Tipo di Entità

name
required
string

Nome canonico del Tipo di Entità

syntax
required
string <json>

Definizione (JSON-LD) della sintassi del Tipo di Entità

object (Terminology)

Nomenclatura di riferimento per i Tipi di Entità. Può essere interna o esterna (schema.gov.it, UCUM, Google Knowledge Graph)

uri
string <uri>

URI autoritativo del Tipo (se non nativo)

Responses

Request samples

Content type
application/json
{}

Restituisce un singolo Tipo di Entità

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{}

Modifica un Tipo esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string
Request Body schema: application/json
required
id
required
string <uri>

Identificativo univoco del Tipo di Entità

name
required
string

Nome canonico del Tipo di Entità

syntax
required
string <json>

Definizione (JSON-LD) della sintassi del Tipo di Entità

object (Terminology)

Nomenclatura di riferimento per i Tipi di Entità. Può essere interna o esterna (schema.gov.it, UCUM, Google Knowledge Graph)

uri
string <uri>

URI autoritativo del Tipo (se non nativo)

Responses

Request samples

Content type
application/json
{}

Elimina un Tipo (senza istanze di elementi) esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string

Responses

Restituisce le Nomenclature definite

Authorizations:
panorama_consumer_api_key

Responses

Response samples

Content type
application/json
[]

Crea una nuova Nomenclatura (admin only)

Authorizations:
panorama_administrator_api_key
Request Body schema: application/json
required
id
required
string <uri>

Identificativo univoco della Nomenclatura (terminology)

name
required
string

Nome canonico della Nomenclatura

description
string

Descrizione della Nomenclatura

documentation
string <uri>

Link alla documentazione della Nomenclatura

subject
string

Soggetto titolare del Tipo

uri
string <uri>

URI autoritativa della Nomenclatura

Responses

Request samples

Content type
application/json
{}

Restituisce una singola Nomenclatura

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{}

Modifica una Nomenclatura esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string
Request Body schema: application/json
required
id
required
string <uri>

Identificativo univoco della Nomenclatura (terminology)

name
required
string

Nome canonico della Nomenclatura

description
string

Descrizione della Nomenclatura

documentation
string <uri>

Link alla documentazione della Nomenclatura

subject
string

Soggetto titolare del Tipo

uri
string <uri>

URI autoritativa della Nomenclatura

Responses

Request samples

Content type
application/json
{}

Elimina una Nomenclatura (senza riferimenti in qualche tipo) esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string

Responses

Entity

operations to browse and manage entities

Ricerca di entità

Authorizations:
panorama_consumer_api_key
query Parameters
type
string

Filter by entity type

source
string

Filter by data source

state
string

Filter by entity state

Responses

Response samples

Content type
application/json
[]

Crea una nuova entità

Authorizations:
panorama_provider_api_key
Request Body schema: application/json
required
id
required
string <uri>

ID univoco dell'Entità sulla piattaforma

name
string

Nome canonico dell'Entità sulla piattaforma

object

Coordinate geografiche dell'Entità

required
object (Type)

Tipi di entità, comprensivi di riferimento al nomenclatore e definizione della struttura del payload specifico

parent
object (Entity) Recursive

rappresenta un generico oggetto urbano, è di uno specifico Tipo, afferisce a una Sorgente Dati, ha uno Stato dinamico, è dotato di proprietà type-specific, può avere un DataPoint associato, è tipicamente geo-localizzabile

required
object (Source)

Fonte dati, interna o esterna, relativa a un soggetto alimentante

externalId
string

Identificativo dell'Entità nel sistema sorgente

object

Stato dell'entità

object

Attributi personalizzati in base al tipo di entità

object (DataPoint)

DataPoint associato all'entità

Responses

Request samples

Content type
application/json
{}

Ottiene una singola entità

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{}

Modifica un'entità esistente (escluso lo stato)

Authorizations:
panorama_provider_api_key
path Parameters
id
required
string
Request Body schema: application/json
required
id
required
string <uri>

ID univoco dell'Entità sulla piattaforma

name
string

Nome canonico dell'Entità sulla piattaforma

object

Coordinate geografiche dell'Entità

required
object (Type)

Tipi di entità, comprensivi di riferimento al nomenclatore e definizione della struttura del payload specifico

parent
object (Entity) Recursive

rappresenta un generico oggetto urbano, è di uno specifico Tipo, afferisce a una Sorgente Dati, ha uno Stato dinamico, è dotato di proprietà type-specific, può avere un DataPoint associato, è tipicamente geo-localizzabile

required
object (Source)

Fonte dati, interna o esterna, relativa a un soggetto alimentante

externalId
string

Identificativo dell'Entità nel sistema sorgente

object

Stato dell'entità

object

Attributi personalizzati in base al tipo di entità

object (DataPoint)

DataPoint associato all'entità

Responses

Request samples

Content type
application/json
{}

Elimina un'entità

Authorizations:
panorama_provider_api_key
path Parameters
id
required
string

Responses

Ottiene il data point associato a un'entità

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "serial": "string",
  • "fk_tenant_code": "http://example.com",
  • "fk_service_id": "http://example.com",
  • "gps_latitude": -90,
  • "gps_longitude": -90,
  • "street": "string",
  • "street_number": "string",
  • "city": "string",
  • "postal_code": "string",
  • "createdDate": "2019-08-24T14:15:22Z",
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Modifica lo stato di un'Entità

Authorizations:
panorama_provider_api_key
path Parameters
id
required
string
Request Body schema: application/json
required
string

Responses

Request samples

Content type
application/json
"string"

Ottiene la storia delle variazioni di stato di un'Entità

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

l'ID dell'entità di cui ottenere la storia

Responses

Response samples

Content type
application/json
[
  • {
    }
]

DataPoint

Operations about the Data Point

Elenco di tutti i dispositivi

Authorizations:
panorama_consumer_api_key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Ottiene informazioni su un singolo dispositivo

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "serial": "string",
  • "fk_tenant_code": "http://example.com",
  • "fk_service_id": "http://example.com",
  • "gps_latitude": -90,
  • "gps_longitude": -90,
  • "street": "string",
  • "street_number": "string",
  • "city": "string",
  • "postal_code": "string",
  • "createdDate": "2019-08-24T14:15:22Z",
  • "updatedDate": "2019-08-24T14:15:22Z"
}

Ottiene tutte le misure in un range di date

Authorizations:
panorama_consumer_api_key
query Parameters
measurement_date_from
string <date-time>

Filter by measurement date (from)

measurement_date_to
string <date-time>

Filter by measurement date (to)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Ottiene tutte le misure da un Data Point

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string
query Parameters
measurement_date_from
string <date-time>

Filter by measurement date (from)

measurement_date_to
string <date-time>

Filter by measurement date (to)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Ottieni ultima misura da un data point

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "data_point": "string",
  • "serial": "string",
  • "measure_date": "2019-08-24T14:15:22Z",
  • "measure_name": "string",
  • "unit_of_measurement": "string",
  • "diagnostic": "string",
  • "type": "string",
  • "status": "string",
  • "battery_percentage": 100,
  • "receipt_date": "2019-08-24T14:15:22Z",
  • "created_date": "2019-08-24T14:15:22Z",
  • "updated_date": "2019-08-24T14:15:22Z",
  • "payload": {}
}

Restituisce un singolo tipo di misura

Authorizations:
panorama_consumer_api_key
path Parameters
id
required
string

Responses

Response samples

Content type
application/json

Modifica un tipo di misura esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string
Request Body schema: application/json
required
id
required
string <uri>

Identificativo univoco del Tipo di Misura

name
required
string

Nome canonico del Tipo di Misura

syntax
required
string <json>

Definizione (JSON-LD) della sintassi del Tipo di Misura

Responses

Request samples

Content type
application/json

Elimina un tipo di misura esistente (admin only)

Authorizations:
panorama_administrator_api_key
path Parameters
id
required
string

Responses

Restituisce tutti i tipi di misura definiti

Authorizations:
panorama_consumer_api_key

Responses

Response samples

Content type
application/json

Crea un nuovo tipo di misura (admin only)

Authorizations:
panorama_administrator_api_key
Request Body schema: application/json
required
id
required
string <uri>

Identificativo univoco del Tipo di Misura

name
required
string

Nome canonico del Tipo di Misura

syntax
required
string <json>

Definizione (JSON-LD) della sintassi del Tipo di Misura

Responses

Request samples

Content type
application/json