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

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

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

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

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

{interloper_api-0.15.1 → 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.15.1 → interloper_api-0.17.0}/src/interloper_api/routes/external/__init__.py

@@ -36,15 +36,21 @@ 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
+from interloper_api.routes.external.impact import sub_router as impact_router  # noqa: E402
 from interloper_api.routes.external.pinterest_ads import sub_router as pinterest_ads_router  # noqa: E402
 from interloper_api.routes.external.snapchat_ads import sub_router as snapchat_ads_router  # noqa: E402
+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)
+router.include_router(impact_router)
 router.include_router(pinterest_ads_router)
 router.include_router(snapchat_ads_router)
+router.include_router(tiktok_ads_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 []

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

@@ -0,0 +1,54 @@
+"""Impact 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.impact.com"
+
+
+class ImpactConnectionRequest(BaseModel):
+    """Impact connection credentials (matches ImpactConnection fields)."""
+
+    account_sid: str
+    auth_token: str
+
+
+@sub_router.post("/impact/programs")
+async def impact_programs(
+    body: ImpactConnectionRequest,
+    _user: Profile = Depends(require_viewer),
+) -> list[dict[str, str]]:
+    """Fetch Impact programs (campaigns) accessible by the connection."""
+    try:
+        programs: list[dict[str, str]] = []
+        async with httpx.AsyncClient(
+            timeout=30,
+            auth=httpx.BasicAuth(body.account_sid, body.auth_token),
+            headers={"Accept": "application/json"},
+        ) as client:
+            page, num_pages = 1, 1
+            while page <= num_pages:
+                resp = await client.get(
+                    f"{_BASE_URL}/Advertisers/{body.account_sid}/Campaigns",
+                    params={"Page": page},
+                )
+                resp.raise_for_status()
+                data = resp.json()
+                num_pages = int(data["@numpages"])
+                for campaign in data.get("Campaigns", []):
+                    programs.append({"Id": campaign["Id"], "Name": campaign.get("Name", campaign["Id"])})
+                page += 1
+
+        return programs
+    except Exception as exc:
+        handle_error(exc, "fetching Impact programs")
+        return []

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

@@ -0,0 +1,70 @@
+"""TikTok Ads external API routes."""
+
+from __future__ import annotations
+
+import os
+
+import httpx
+from fastapi import APIRouter, Depends, HTTPException
+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://business-api.tiktok.com/open_api/v1.3"
+_ADVERTISERS_URL = f"{_BASE_URL}/oauth2/advertiser/get/"
+
+
+class TiktokAdsConnectionRequest(BaseModel):
+    """TikTok Ads connection credentials (matches TiktokAdsConnection fields)."""
+
+    access_token: str
+
+
+async def _list_advertisers(
+    client: httpx.AsyncClient,
+    access_token: str,
+    app_id: str,
+    secret: str,
+) -> list[dict[str, str]]:
+    """List the advertisers the access token can access, sorted by name."""
+    resp = await client.get(
+        _ADVERTISERS_URL,
+        params={"app_id": app_id, "secret": secret},
+        headers={"Access-Token": access_token},
+    )
+    resp.raise_for_status()
+    body = resp.json()
+    if body.get("code") != 0:
+        raise HTTPException(status_code=502, detail=f"TikTok API error: {body.get('message')}")
+
+    advertisers = body.get("data", {}).get("list", [])
+    results = [
+        {"advertiser_id": a["advertiser_id"], "name": a.get("advertiser_name") or a["advertiser_id"]}
+        for a in advertisers
+    ]
+    return sorted(results, key=lambda a: a["name"].lower())
+
+
+@sub_router.post("/tiktok-ads/advertisers")
+async def tiktok_ads_advertisers(
+    body: TiktokAdsConnectionRequest,
+    _user: Profile = Depends(require_viewer),
+) -> list[dict[str, str]]:
+    """Fetch the TikTok advertisers accessible by the connection.
+
+    Listing advertisers needs the connector app's ``app_id`` / ``secret`` — read
+    from the provider-scoped environment (``TIKTOK_CLIENT_ID`` /
+    ``TIKTOK_CLIENT_SECRET``) — alongside the connection's access token.
+    """
+    try:
+        app_id = os.environ.get("TIKTOK_CLIENT_ID", "")
+        secret = os.environ.get("TIKTOK_CLIENT_SECRET", "")
+        async with httpx.AsyncClient(timeout=30) as client:
+            return await _list_advertisers(client, body.access_token, app_id, secret)
+    except Exception as exc:
+        handle_error(exc, "fetching TikTok Ads advertisers")
+        return []