L'API di OpenCUP è un'interfaccia applicativa che permette a qualunque componente software esterno di accedere ai dati contenuti nel sistema CUP e consultare le informazioni rese disponibili su OpenCUP relative ai singoli CUP.
L'API di OpenCUP adotta l'architettura REST, e i dati sono resi disponibili in formato JSON e formato HTML.
Se non altrimenti specificato, le risorse sono presentate in formato JSON, mentre per accedere al formato HTML di una risorsa, si deve aggiungere il parametro flag_json=false, come indicato nel seguente esempio:
(JSON) https://api.sogei.it/rgs/opencup/o/extServiceApi/v1/opendataes/cup/J48C14000270006
(HTML) https://api.sogei.it/rgs/opencup/o/extServiceApi/v1/opendataes/cup/J48C14000270006?flag_json=false
I servizi esposti possono essere interrogati per:
codice CUP, specificando nella stringa il CUP
esempio: https://api.sogei.it/rgs/opencup/o/extServiceApi/v1/opendataes/cup/J48C14000270006
oppure per soggetto titolare, specificando nella stringa la partita iva del soggetto titolare esempio: https://api.sogei.it/rgs/opencup/o/extServiceApi/v1/opendataes/soggettotitolare/01206740324
Per registrarsi ai servizi di interoperabilità sopra esposti è possibile inoltrare la richiesta mediante il form contattaci