interloper-api 0.16.0__tar.gz → 0.17.0__tar.gz

{interloper_api-0.16.0 → interloper_api-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: interloper-api
-Version: 0.16.0
+Version: 0.17.0
 Summary: Interloper FastAPI routes
 Author: Guillaume Onfroy
 Author-email: Guillaume Onfroy <guillaume@digitlcloud.com>

{interloper_api-0.16.0 → interloper_api-0.17.0}/pyproject.toml

@@ -3,7 +3,7 @@
 # ###############
 [project]
 name = "interloper-api"
-version = "0.16.0"
+version = "0.17.0"
 description = "Interloper FastAPI routes"
 readme = "README.md"
 authors = [{ name = "Guillaume Onfroy", email = "guillaume@digitlcloud.com" }]

{interloper_api-0.16.0 → interloper_api-0.17.0}/src/interloper_api/app.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import logging
 from typing import Any
 
 from fastapi import APIRouter, FastAPI
@@ -27,6 +28,8 @@ from interloper_api.routes import (
 )
 from interloper_api.routes import catalog as catalog_routes
 
+logger = logging.getLogger(__name__)
+
 
 def create_app(
     store: Store | None = None,
@@ -91,7 +94,10 @@ def create_app(
 
         api.include_router(agent_routes.router, prefix="/agent", tags=["agent"])
     except ImportError:
-        pass
+        logger.warning(
+            "Agent routes not mounted: the 'agent' extra is not installed "
+            "(install interloper-api[agent]); /agent endpoints will return 404."
+        )
 
     @api.get("/health")
     def health() -> dict[str, str]:

{interloper_api-0.16.0 → interloper_api-0.17.0}/src/interloper_api/routes/external/__init__.py

@@ -36,6 +36,7 @@ def handle_error(error: Exception, context: str) -> None:
 
 # Import and register sub-routers after helpers are defined.
 from interloper_api.routes.external.amazon_ads import sub_router as amazon_ads_router  # noqa: E402
+from interloper_api.routes.external.criteo import sub_router as criteo_router  # noqa: E402
 from interloper_api.routes.external.facebook_ads import sub_router as facebook_ads_router  # noqa: E402
 from interloper_api.routes.external.google_ads import sub_router as google_ads_router  # noqa: E402
 from interloper_api.routes.external.google_cloud import sub_router as google_cloud_router  # noqa: E402
@@ -45,6 +46,7 @@ from interloper_api.routes.external.snapchat_ads import sub_router as snapchat_a
 from interloper_api.routes.external.tiktok_ads import sub_router as tiktok_ads_router  # noqa: E402
 
 router.include_router(amazon_ads_router)
+router.include_router(criteo_router)
 router.include_router(facebook_ads_router)
 router.include_router(google_ads_router)
 router.include_router(google_cloud_router)

interloper_api-0.17.0/src/interloper_api/routes/external/criteo.py

@@ -0,0 +1,68 @@
+"""Criteo external API routes."""
+
+from __future__ import annotations
+
+import httpx
+from fastapi import APIRouter, Depends
+from interloper_db import Profile
+from pydantic import BaseModel
+
+from interloper_api.dependencies import require_viewer
+from interloper_api.routes.external import handle_error
+
+sub_router = APIRouter()
+
+_BASE_URL = "https://api.criteo.com"
+_TOKEN_URL = f"{_BASE_URL}/oauth2/token"
+_ADVERTISERS_URL = f"{_BASE_URL}/2025-04/advertisers/me"
+
+
+class CriteoConnectionRequest(BaseModel):
+    """Criteo connection credentials (matches CriteoConnection fields)."""
+
+    client_id: str
+    client_secret: str
+    refresh_token: str
+
+
+async def _get_access_token(client: httpx.AsyncClient, body: CriteoConnectionRequest) -> str:
+    """Exchange the refresh token for an access token."""
+    resp = await client.post(
+        _TOKEN_URL,
+        data={
+            "grant_type": "refresh_token",
+            "client_id": body.client_id,
+            "client_secret": body.client_secret,
+            "refresh_token": body.refresh_token,
+        },
+    )
+    resp.raise_for_status()
+    return resp.json()["access_token"]
+
+
+async def _list_advertisers(client: httpx.AsyncClient, body: CriteoConnectionRequest) -> list[dict[str, str]]:
+    """List the advertisers the connection can access, sorted by name."""
+    token = await _get_access_token(client, body)
+    resp = await client.get(_ADVERTISERS_URL, headers={"Authorization": f"Bearer {token}"})
+    resp.raise_for_status()
+
+    advertisers = resp.json().get("data", [])
+    results = [
+        {"id": a["id"], "name": a.get("attributes", {}).get("advertiserName") or a["id"]}
+        for a in advertisers
+    ]
+    return sorted(results, key=lambda a: a["name"].lower())
+
+
+@sub_router.post("/criteo/advertisers")
+async def criteo_advertisers(
+    body: CriteoConnectionRequest,
+    _user: Profile = Depends(require_viewer),
+) -> list[dict[str, str]]:
+    """Fetch the Criteo advertisers accessible by the connection."""
+    try:
+        async with httpx.AsyncClient(timeout=30) as client:
+            return await _list_advertisers(client, body)
+    except Exception as exc:
+        handle_error(exc, "fetching Criteo advertisers")
+        return []