apiempresas 1.0.0__py3-none-any.whl

apiempresas/__init__.py

@@ -0,0 +1,4 @@
+from .client import ApiEmpresas
+from .exceptions import ApiError
+
+__all__ = ["ApiEmpresas", "ApiError"]

apiempresas/client.py

@@ -0,0 +1,69 @@
+import requests
+from .exceptions import ApiError
+from .resources.companies import Companies
+
+class ApiEmpresas:
+    """
+    Cliente principal para interactuar con la API de APIEmpresas.es
+    """
+    def __init__(self, api_key: str, base_url: str = 'https://apiempresas.es/api/v1', timeout: int = 30):
+        if not api_key or not api_key.strip():
+            raise ApiError("La propiedad 'api_key' es obligatoria para inicializar ApiEmpresas.", status=401)
+        
+        self.api_key = api_key
+        self.base_url = base_url.rstrip('/')
+        self.timeout = timeout
+        
+        # Iniciar sesión de requests para reutilizar conexiones
+        self.session = requests.Session()
+        self.session.headers.update({
+            'X-API-KEY': self.api_key,
+            'Accept': 'application/json',
+        })
+        
+        # Inicializar recursos
+        self.companies = Companies(self)
+
+    def request(self, method: str, endpoint: str, params: dict = None, json_data: dict = None) -> dict:
+        """
+        Método interno genérico para lanzar las peticiones HTTP.
+        """
+        url = f"{self.base_url}{endpoint}"
+        
+        try:
+            response = self.session.request(
+                method=method,
+                url=url,
+                params=params,
+                json=json_data,
+                timeout=self.timeout
+            )
+        except requests.exceptions.RequestException as e:
+            raise ApiError(f"Error de red al conectar con APIEmpresas: {str(e)}", status=500)
+            
+        try:
+            decoded_data = response.json()
+        except ValueError:
+            decoded_data = None
+            
+        if not response.ok:
+            status = response.status_code
+            message = f"{status} Error desconocido en la API"
+            error_code = None
+            
+            if decoded_data and isinstance(decoded_data, dict):
+                message = decoded_data.get('message', message)
+                error_code = decoded_data.get('error')
+            else:
+                message = response.text
+                
+            raise ApiError(message, status=status, error_code=error_code, raw_data=decoded_data)
+            
+        if decoded_data and 'data' in decoded_data:
+            # Para el endpoint /batch, se suele devolver meta y data
+            if 'meta' in decoded_data:
+                return decoded_data
+            return decoded_data['data']
+            
+        return decoded_data
+

apiempresas/exceptions.py

@@ -0,0 +1,9 @@
+class ApiError(Exception):
+    """
+    Excepción lanzada cuando la API de APIEmpresas devuelve un error.
+    """
+    def __init__(self, message: str, status: int = 500, error_code: str = None, raw_data: dict = None):
+        super().__init__(message)
+        self.status = status
+        self.error_code = error_code
+        self.raw_data = raw_data

apiempresas/resources/__init__.py

@@ -0,0 +1 @@
+# vacio

apiempresas/resources/companies.py

@@ -0,0 +1,47 @@
+class Companies:
+    def __init__(self, client):
+        self._client = client
+
+    def get(self, cif: str) -> dict:
+        """Obtiene los datos básicos de una empresa por su CIF."""
+        return self._client.request('GET', '/companies', params={'cif': cif})
+
+    def search(self, q: str) -> dict:
+        """Busca empresas por nombre o razón social."""
+        return self._client.request('GET', '/companies/search', params={'q': q})
+
+    def batch(self, cifs: list) -> dict:
+        """Consulta múltiple de CIFs en una sola petición."""
+        return self._client.request('POST', '/companies/batch', json_data={'cifs': cifs})
+
+    def score(self, cif: str) -> dict:
+        """(Pro) Obtiene el Scoring Comercial de una empresa."""
+        return self._client.request('GET', '/companies/score', params={'cif': cif})
+
+    def borme(self, cif: str) -> dict:
+        """(Pro) Obtiene el historial de actos del BORME de una empresa."""
+        return self._client.request('GET', '/companies/borme', params={'cif': cif})
+
+    def signals(self, cif: str) -> dict:
+        """(Pro) Obtiene las señales societarias recientes de una empresa."""
+        return self._client.request('GET', '/companies/signals', params={'cif': cif})
+
+    def insights(self, cif: str) -> dict:
+        """(Business) Obtiene Insights IA de una empresa."""
+        return self._client.request('GET', '/companies/insights', params={'cif': cif})
+
+    def contact_prep(self, cif: str) -> dict:
+        """(Pro) Obtiene datos de contacto y preparación de la empresa."""
+        return self._client.request('GET', '/companies/contact-prep', params={'cif': cif})
+
+    def radar(self, cif: str) -> dict:
+        """(Business) Obtiene la información del Radar de empresas."""
+        return self._client.request('GET', '/companies/radar', params={'cif': cif})
+
+    def match(self, cif: str) -> dict:
+        """(Business) Realiza un match avanzado con los datos de una empresa."""
+        return self._client.request('GET', '/companies/match', params={'cif': cif})
+
+    def network(self, cif: str) -> dict:
+        """(Business) Obtiene la red o entramado societario (Network) de una empresa."""
+        return self._client.request('GET', '/companies/network', params={'cif': cif})

apiempresas-1.0.0.dist-info/METADATA

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: apiempresas
+Version: 1.0.0
+Summary: SDK oficial de APIEmpresas.es para Python
+Home-page: https://apiempresas.es
+Author: APIEmpresas
+Author-email: soporte@apiempresas.es
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Requires-Dist: requests>=2.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

apiempresas-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+apiempresas/__init__.py,sha256=FRGZfphzOM68kEBzWBWjnQIK1WyPefMwtHi66k2liiE,104
+apiempresas/client.py,sha256=0WvalOppdYqqOKNlH97da-TL0vtTd7d5SRsR_gk6ESU,2491
+apiempresas/exceptions.py,sha256=5Fu-Gks5cYk66lHgrn3-oPxt1pjM3ncf7Jl7kMth91o,351
+apiempresas/resources/__init__.py,sha256=MEWW1A8fXVWgfx-5IJpuOc0AxIlloO1V-sRQayCX5WM,8
+apiempresas/resources/companies.py,sha256=-y-GCXqI7q7vqhU77ug6x0AhPyYFHOTTFA08GxMIISk,2255
+apiempresas-1.0.0.dist-info/METADATA,sha256=rQThCw8mORoPmMnGAnsNsWd5PaYNNf6WynyFzm-NNAM,506
+apiempresas-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+apiempresas-1.0.0.dist-info/top_level.txt,sha256=Gu0FWbneYrHgJwbSD0oBINxXyENpr9z50eSNLMam9Is,12
+apiempresas-1.0.0.dist-info/RECORD,,

apiempresas-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

apiempresas-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+apiempresas