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




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





• 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





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





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





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





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





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).

normas generales - normativaconstruccion.cl · normas generales director: juan jorge lazo...

Documents