Normas Generales - normativaconstruccion.cl · Normas Generales Director: Juan Jorge Lazo...
Transcript of Normas Generales - normativaconstruccion.cl · Normas Generales Director: Juan Jorge Lazo...
ISECCIÓN
LEYES, REGLAMENTOS, DECRETOS Y RESOLUCIONES DE ORDEN GENERAL
Núm. 42.581 Lunes 17 de Febrero de 2020 Página 1 de 8
CVE 1726612
Normas Generales
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
MINISTERIO DEL MEDIO AMBIENTE
SuperintendenciadelMedioAmbiente
APRUEBA “MANUAL API REST - SMA. VERSIÓN 1.0 - FEBRERO 2020”
(Resolución)
Núm.254exenta.-Santiago,10defebrerode2020.
Vistos:
LodispuestoenlaleyorgánicadelaSuperintendenciadelMedioAmbiente,fijadaenelartículosegundodelaleyNº20.417,quecreaelMinisterio,elServiciodeEvaluaciónAmbientalylaSuperintendenciadelMedioAmbiente(LOSMA);enlaLeyNº19.880,queestablecelasBasesdelosProcedimientosAdministrativosquerigenlosActosdelosÓrganosdelaAdministracióndelEstado;eneldecretoconfuerzadeleyNº1/19.653,de2001,quefijatextorefundido,coordinadoysistematizadodelaleyNº18.575,OrgánicaConstitucionaldeBasesGeneralesdelaAdministracióndelEstado;enlaLeyNº19.300,sobreBasesGeneralesdelMedioAmbiente;enlaleyNº18.834,queApruebaelEstatutoAdministrativo;enlaresoluciónexentaNº424,de12demayode2017,delaSuperintendenciadelMedioAmbiente,quefijalaOrganizaciónInternadelaSuperintendenciadelMedioAmbiente;enlasresolucionesexentasNº559,de14demayode2018,Nº438,de28demarzode2019,yNº1.619,de21denoviembrede2019,quemodificanlaresoluciónexentaNº424,de2017;eneldecretoconfuerzadeleyNº3,de11deseptiembrede2010,delMinisterioSecretaríaGeneraldelaPresidencia,quefijalaPlantadePersonaldelaSuperintendenciadelMedioAmbienteysuRégimendeRemuneraciones;enlaresoluciónexentaRANº119123/129/2019,de6deseptiembrede2019,delaSuperintendenciadelMedioAmbiente,quenombraadonEmanuelIbarraSotoencalidaddetitularenelcargodeFiscaldelaSuperintendenciadelMedioAmbiente;y,enlaresoluciónNº7,de16demarzode2019,delaContraloríaGeneraldelaRepública,queFijaNormasSobreExencióndelTrámitedeTomadeRazón.
Considerando:
1.ElartículosegundodelaLOSMAdisponequelaSuperintendenciadelMedioAmbiente(SMA),fuecreadaconelobjetoejecutar,organizarycoordinarelseguimientoyfiscalizacióndelasResolucionesdeCalificaciónAmbiental,delasmedidasdelosPlanesdePrevencióny,odeDescontaminaciónAmbiental,delcontenidodelasNormasdeCalidadAmbientalyNormasdeEmisión,ydelosPlanesdeManejo,cuandocorresponda,ydetodosaquellosotrosinstrumentosdecarácterambientalqueestablezcalaley;asícomoimponersancionesencasoqueseconstateninfraccionesdesucompetencia.
2.Envirtuddesusfacultadeslegales,laSMAmedianteresoluciónexentaNº126,de23deenerode2020,aprobóla“InstrucciónGeneralparalaConexiónenLíneayReportesdeSeguimientodelasEstacionesdeVigilanciadelaCalidaddelAirequeIndica”.
3.Endichainstrucción,enrelaciónalaformaderealizarlaconexiónenlíneaseindicóque“laSMAdispondrádeunaAPIquepermitirálacomunicaciónconlaSMA,incluyendotantolaconexiónenlínea,comolaentregadelosreportesdeseguimientoparaverificarelcumplimientodeloscompromisosestablecidosencadaICA.Enestesentido,seutilizaránloscódigosdeldecretosupremoNº61,delaño2009,delMinisteriodeSalud,oelqueloreemplace,paracaracterizarlosdatosinválidos(calibraciones,vacíosdeinformación,etc.).Porlotanto,pormediodeestaAPI,sedeberánreportartodoslosdatosnecesariosparalograrlosobjetivosestablecidosenestainstrucción(...)”.
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 2 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
4.Enlamismalínea,medianteresoluciónexentaNº1.574,de12denoviembrede2020,delaSMAseaprobóla“InstrucciónGeneralparalaConexiónenLíneadelosSistemasdeMonitoreoContinuodeEmisiones-CEMS”.
5.Asimismo,existenInstrumentosdeCarácterAmbientalqueestablecenlaobligacióndereportarinformaciónentiemporeal.
6.Paratalesfines,laSMAhadeterminadolanecesidaddedefinirloslineamientostécnicosparaimplementarelservicioAPIRESTdefinidoporesteservicio,tantoparaelenvíodedatosdemonitoreoenlínea,comoparaladisposicióndedatoshistóricosquepuedanserconsultados.
7.Que,enatenciónaloanteriormenteexpuesto,seprocedearesolverlosiguiente:
Resuelvo:
Primero:Apruébaseeldocumentodenominado“ManualAPIREST-SMA.Versión1.0-febrero2020”,cuyotextoacontinuaciónsetranscribe:
“MANUALAPIRESTSMA.VERSIÓN1.0-FEBRERO2020”
1.Introducción
LaSuperintendenciadelMedioAmbiente(SMA)tieneporobjetoejecutar,organizarycoordinarelseguimientoyfiscalizacióndelasResolucionesdeCalificaciónAmbiental,delasmedidasdelosPlanesdePrevencióny/odeDescontaminaciónAmbiental,delcontenidodelasNormasdeCalidadAmbientalyNormasdeEmisión,ydelosPlanesdeManejo,cuandocorresponda,ydetodosaquellosotrosInstrumentosdeCarácterAmbientalqueestablezcalaley,asícomoimponersancionesencasoqueseconstateninfraccionesdesucompetencia.
Paraello,laSMApodrárequerirasujetossometidosasufiscalizaciónyalosorganismossectorialesquecumplanlaboresdefiscalizaciónambiental,lainformaciónydatosqueseannecesariosparaeldebidocumplimientodesusfunciones.Enestecontexto,existenInstrumentosdeCarácterAmbientalqueestablecenlaobligacióndereportarinformaciónentiemporeal,ademásdeinstruccionesdecaráctergeneraldelaSMAparalaconexiónenlíneadeinstrumentosdemonitoreoambiental.
ElpresentedocumentodefineloslineamientostécnicosparaimplementarelservicioAPIRESTdefinidoporlaSMA,tantoparaelenvíodedatosdemonitoreoenlínea,comoparaladisposicióndedatoshistóricosquepuedanserconsultados.
Losconceptosymetodologíasmencionadasenestedocumentosebasanenestándaresdelámbitodelastecnologíasdelainformación,porloqueserecomiendaqueunprofesionaldeláreadelaInformáticaseaquienimplementelaconexión.
2.Glosario
• API:InterfazdeProgramacióndeAplicaciones(delinglésApplicationProgrammingInterface),esunconjuntodesubrutinas,funcionesyprocedimientosqueofreceunproveedorenespecíficoparaserutilizadosporotrosoftwarecomounacapadeabstracción.Permitelaintegraciónentresistemasinformáticos.
• CEMS:Sistemademonitoreocontinuodeemisiones(continuousemissionsmonitoringsystem).
• ENDPOINT:URLquerecibeoretornainformaciónprovenientedeunaAPI.• HTTPREQUEST:PeticiónmedianteelprotocoloHTTPqueesenviadaaunendpointespecifico.• HTTP:Protocolodetransferenciadehipertexto(delinglésHypertextTransferProtocol).Es
elprotocolodecomunicaciónquepermitelastransferenciasdeinformaciónenlaWorldWideWeb.
• JSON:(delinglésJavaScriptObjectNotation).Esunformatodetextosencilloparaelintercambiodedatos.1
• JWT:JSONWebToken.EsunestándarabiertobasadoenJSONparalacreacióndetokensdeaccesoquepermitenlapropagacióndeidentidadyprivilegios2.
• REST:TransferenciadeEstadoRepresentacional(delinglésRepresentationalStateTransfer),esunesquemadearquitecturadesoftwareparasistemashipermediadistribuidos.SeutilizaparadescribirinterfacesentresistemasqueutilicenelprotocoloHTTPparaobtenerdatosoindicarlaejecucióndeoperacionessobredatos.
• URI:IdentificadorUniformedeRecursos(delinglésUniformResourceIdentifier)seusaparaidentificarrecursoseninternet
1https://tools.ietf.org/html/rfc82592https://tools.ietf.org/html/rfc7519
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 3 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
• URL:LocalizadorUniformedeRecursos(delinglésUniformResourceLocator)seusaparalocalizarrecursoseninternet
• WWW:RedInformáticaMundial(delinglésWorldWideWeb)esunsistemadedistribucióndedocumentosdehipertextoohipermediainterconectadosyaccesiblesatravésdeinternet.
3.Registrodemetadatosyentregadecredenciales
LostitularesquedebantransmitirdatosalaSMApormediodelaAPIRESTtendránquecompletarelregistrodemetadatosasociadoasuescenariodemonitoreo,atravésdelformulariodispuestoporlaSMAparaestosfines.Posterioraello,eltitularrecibirálascredencialesdeaccesoparareportarsusdatosatravésdelaAPI.
Elregistrodemetadatostieneporobjetivogeneraruncatastrodelaconfiguracióndelescenariodemonitoreo,siguiendoelsiguienteesquema.EstacaracterizacióndeberásercargadaenunformularioquelaSMAdispondráypublicaráensusitioweb.Luegoderevisadolosantecedentes,laSMAproporcionarálascredencialesparaenviardatos,atravésdelservicioAPIREST,juntoconlosidentificadoresdeUnidadFiscalizable,ProcesosyDispositivosquecorrespondan.
4.EnvíodedatosenlíneaaSMA,víaAPIREST
TodoslostitularesquetenganlaobligacióndereportardatosenlíneaalaSMA,deberánseguirlossiguienteslineamientosparaelusodelservicioAPIREST.
4.1.URLBase:
TodoslosendpointsdescritosenestaguíaparareportardatosalaSMAdeberánutilizarcomoURLbaselasiguientedirección:conexiones.sma.gob.cl
4.2.FlujodeAutenticaciónyconsumodeEndpointsdelaAPI
Luegodecompletadalaetapadecaracterización,eltitularrecibirálascredencialesquelepermitirániniciarsesiónenlaAPI,segúnelframeworkdeautenticaciónHTTP3.Lasiguienteimagenresumeelflujodelaautenticaciónyconsumoposteriordelosendpoints,pormediodeuntokendeautenticación(JWT).
3 https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 4 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
4.3.EndpointdeAutenticación
Descripción:PormediodeesteendpointeltitularpodráautenticarsecontraelservicioAPIREST,usandolascredencialesproporcionadas.Sielrequestescorrecto,retornaráuntokendeautenticación(JWT)elcualesrequeridoparaconsumircualquierotroendpointdelaAPI.
URI:/api/v1/auth
Método:POST
RequestJSON:
Response:
• HTTPstatus4:200OK,400BadRequest,401Unauthorized,403Forbidden,500InternalServerError
• Body:JWT
Observaciones:Eltokenobtenidoporestavíatendráunavalidezde24horas,posterioraelloeltitulardeberávolveragenerareltokenparaseguirconsumiendolosendpointsdelaAPI.
4.4.EndpointdeRegistros
Descripción:Pormediodeesteendpointeltitulardeberáreportarlosdatoscorrespondientesalosparámetrosmonitoreadosdeformacontinua,segúnlafrecuenciaquecorresponda.ParaestodeberáconstruirlallamadaalservicioAPIRestusandolosidentificadoresproporcionadoseincluyendolacabeceradelallamadadeltokendeautenticación.
URI:/api/v1/ufs/<UFld>/procesos/<Procesold>/registros
Método:Post
Header:
RequestArrayJSON:
4https://tools.ietf.org/html/rfc2616#section-10.2.1
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 5 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
EjemploRequestArrayJSON:
Response:
• HTTPStatus5:200OK,201Created,400BadRequest,401Unauthorized,403Forbidden,500InternalServerError
• ResponseBody:JSON
Observaciones:
Sedeberánenviartodoslosparámetrosquetenganunamismaestampadetiempoenunaúnicallamadaalendpoint,atravésdelarregloJSONaconstruir.EstoserávalidadoporlaAPIalmomento
5https://tools.ietf.org/html/rfc2616#section-10.2.1
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 6 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
derecibircadallamada,devolviendoerror(HTTPstatus400)encasodefaltaroexcederlacantidaddeparámetrosacargar.
5.Datoshistóricosdisponibles,víaAPIREST
TodoslostitularesquetenganlaobligacióndedisponerdeunservicioAPIRESTparaconsultadedatoshistóricosporpartedelaSMA,deberánseguirlossiguienteslineamientosalconstruirelservicio.
5.1.URLBASE
LaURLbaseparalaAPIRESTsedebedisponerpormediodeunregistroDNSválidoparainternet.Porejemplo:
api.midominio.comwww.midominio.comapi.midominio.net
Deformaalternativa,aquellostitularesconectadosalaSMApormediodeMPLS,podrándisponerunaIPdesuredlocal.
5.2.FlujodeAutenticaciónyconsumodeendpointsdelaAPI
EltitulardeberágenerarcredencialesdeaccesoalaAPIexclusivasparalaSMA,quepermitaniniciarsesión,segúnelframeworkdeautenticaciónHTTP6.EltitulardeberádisponerdeunendpointendonderecibalascredencialesatravésdelrequestJSON.
Lasiguienteimagenresumeelflujodelaautenticaciónyconsumoposteriordelosendpoints:
Observaciones:LaURIdesplegadasenlaimagensonamododeejemplo.EltitulardeberáproponerunaestructuraparaorganizarlosrecursosdelaAPI,paralocualrecomendamosseguirlaspautaspropuestasporMicrosoft7paralaconstruccióndeserviciosAPIREST.
5.3.EndpointdeAutenticación
Descripción:PormediodeesteendpointlaSMApodráautenticarsecontraelservicioAPIRESTdispuestoporeltitular,usandolascredencialesdispuestasparaestefin.Elendpointdeberetornaruntokendeautenticación(JWT)elcualesrequeridoparaconsumircualquierotroendpointdelaAPI,medianteelesquemadeautenticaciónBearer8.
6https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication7https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md8https://tools.ietf.org/html/rfc6750
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 7 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
URI:Definidaporeltitular
Método:POST
RequestJson:
Response:
• HTTPStatus9:200OK,400BadRequest,401Unauthorized,403Forbidden,500Interna’ServerError
• ResponseBody:JWT
Observaciones:Eltokenobtenidoporestavíadebetenerunavalidezde24horas,sinlaopciónderefrescareltoken.PasadoesteplazolaSMAobtendráunnuevotokenatravésdeesteendpointparaseguirconsumiendolosendpointsdelaAPI.
5.4.EndpointdeRegistros
Descripción:PormediodeesteendpointeltitulardispondrálosdatoshistóricosdetelemetríaasociadosalprocesodelcualdebereportaralaSMA.EstemétododeberecibircomoparámetrolosidentificadoresdedispositivoydefechaaconsultarmediantelaURIdelmétodoGET.EltitulardeberáretornarunJSONconlosdatossegúnlaestructuradeterminadaporlaSMA.Elendpointalmenosdeberetornartodoslosdatospertenecientesaunafechaenparticularrecibidacomoparámetro.
URI:Definidaporeltitular,recibeenlaURIlosparámetrosdedispositivoyfechaaconsultarMétodo:GET
Response:
• HTTPStatus10:200OK,400BadRequest,401Unauthorized,403Forbidden,500InternalServerError
• ResponseBody:JSON
EjemploResponseArrayJSON:
9https://tools.ietf.org/html/rfc2616#section-10.2.110https://tools.itef.org/html/rfc2616#section-10.2.1
DIARIO OFICIAL DE LA REPUBLICA DE CHILELunes 17 de Febrero de 2020Núm. 42.581 Página 8 de 8
Director: Juan Jorge Lazo RodríguezSitio Web:www.diarioficial.cl
Mesa Central: +56 2 24863600 E-mail: [email protected]ón:Dr.TorresBoonenN°511,Providencia,Santiago,Chile.CVE 1726612
Este documento ha sido firmado electrónicamente de acuerdo con la ley N°19.799 e incluye sellado de tiempo y firma electrónicaavanzada. Para verificar la autenticidad de una representación impresa del mismo, ingrese este código en el sitio web www.diarioficial.cl
TabladescriptivaCamposenResponseArrayJSON
Observaciones:
Sedeberánenviartodoslosdatosdelosparámetrospertenecientesaldispositivosegúnlafechadelallamadaquecorresponda,atravésdelarregloJSONaconstruir.
6.Anexos
Lasespecificacionesdeparámetros,unidades,estadosyetiquetasestarándeterminadasenlosanexosqueseincorporaránalpresentemanual,cuyasmodificacionesseráncomunicadasenlapáginawebdelaSMA,yentodaslasplataformasdigitalesqueéstamaneja”.
Segundo:PublíqueselapresenteresoluciónenelDiarioOficial,quedandodisponibleeldocumentoqueapruebalamisma,enlapáginawebdelSistemaNacionaldeInformacióndeFiscalizaciónAmbiental:http://snifa.sma.gob.cl.
Tercero:Vigencia.LapresenteinstrucciónentraráenvigenciaacontardesufechadepublicaciónenelDiarioOficial.
Anótese,publíqueseenelDiarioOficial,desecumplimientoyarchívese.-EmanuelIbarraSoto,SuperintendentedelMedioAmbiente(S).