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

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

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

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

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

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

@@ -39,12 +39,16 @@ from interloper_api.routes.external.amazon_ads import sub_router as amazon_ads_r
 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(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.16.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.16.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 []