{"servicio":"Puerta Sigma","que_es":"Punto unico de acceso de solo lectura a la API del ERP Sigma para las aplicaciones del grupo. Serializa las llamadas y comparte una cache, porque Sigma limita el ritmo y varias aplicaciones consultando por su cuenta se provocan 429 entre ellas.","autenticacion":{"cabecera":"X-Api-Key","como_obtenerla":"Pedirsela al administrador del servidor. Cada aplicacion tiene la suya, revocable por separado. La clave NO se autogestiona."},"endpoints":{"GET /":"Esta guia. No requiere clave.","GET /salud":"Estado del servicio. No requiere clave.","GET /v1/{endpoint}":"Consulta un endpoint de Sigma. Requiere clave. Los parametros se pasan tal cual a Sigma.","POST /v1/cache/vaciar":"Fuerza que la proxima consulta vaya a Sigma. Requiere clave."},"parametros_propios":{"todas":"true recorre todas las paginas y devuelve el conjunto completo.","refrescar":"true saltea la cache. Cada refresco es una espera real contra Sigma."},"solo_lectura":{"permitido":["Export","CurrentTimeStamp","help"],"nota":"Cualquier otro endpoint devuelve 403 sin salir a la red. Los Import* y Modificacion* de Sigma NO son alcanzables por esta puerta."},"para_aprender_la_api_de_sigma":{"llamada":"GET /v1/help?format=md","que_devuelve":"La documentacion completa de la API Sigma v10 en Markdown, dentro del campo 'contenido'. Son ~58 endpoints. Es el punto de partida recomendado para un agente que tenga que integrarse."},"forma_de_la_respuesta":{"endpoint":"el endpoint consultado","registros":"cantidad de registros devueltos","de_cache":"true si no se consulto a Sigma","edad_segundos":"antiguedad del dato cacheado","datos":"la respuesta de Sigma, tal cual"},"limites":{"por_aplicacion":"30 peticiones por minuto","hacia_sigma":"Las llamadas se serializan y se espera entre repeticiones del mismo endpoint. Traer un maestro completo puede tardar minutos: no lo llames en el camino de una peticion web, hacelo en una tarea de fondo."},"ejemplo":"curl -H 'X-Api-Key: TU-CLAVE' 'https://sigma.grupodanoa.ar/v1/ExportClientes?todas=true'"}