apiempresas 1.0.0__tar.gz

apiempresas-1.0.0/PKG-INFO

@@ -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/apiempresas/__init__.py

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

apiempresas-1.0.0/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-1.0.0/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-1.0.0/apiempresas/resources/__init__.py

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

apiempresas-1.0.0/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/apiempresas.egg-info/PKG-INFO

@@ -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/apiempresas.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+setup.py
+apiempresas/__init__.py
+apiempresas/client.py
+apiempresas/exceptions.py
+apiempresas.egg-info/PKG-INFO
+apiempresas.egg-info/SOURCES.txt
+apiempresas.egg-info/dependency_links.txt
+apiempresas.egg-info/requires.txt
+apiempresas.egg-info/top_level.txt
+apiempresas/resources/__init__.py
+apiempresas/resources/companies.py
+tests/test_apiempresas.py

apiempresas-1.0.0/apiempresas.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

apiempresas-1.0.0/apiempresas.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.0.0

apiempresas-1.0.0/apiempresas.egg-info/top_level.txt

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

apiempresas-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

apiempresas-1.0.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="apiempresas",
+    version="1.0.0",
+    description="SDK oficial de APIEmpresas.es para Python",
+    author="APIEmpresas",
+    author_email="soporte@apiempresas.es",
+    url="https://apiempresas.es",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.0.0",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.7",
+)

apiempresas-1.0.0/tests/test_apiempresas.py

@@ -0,0 +1,16 @@
+import unittest
+from apiempresas import ApiEmpresas, ApiError
+
+class TestApiEmpresas(unittest.TestCase):
+    def test_missing_api_key(self):
+        with self.assertRaises(ApiError) as context:
+            ApiEmpresas('')
+        self.assertTrue('obligatoria' in str(context.exception))
+
+    def test_init_success(self):
+        client = ApiEmpresas('fake_key')
+        self.assertEqual(client.api_key, 'fake_key')
+        self.assertEqual(client.session.headers['X-API-KEY'], 'fake_key')
+
+if __name__ == '__main__':
+    unittest.main()