api-definition.py

from dotenv import load_dotenv
import os
import requests  # For making HTTP requests
from akamai.edgegrid import EdgeGridAuth, EdgeRc  # For Akamai API authentication
import urllib3
import json

############################## remove before production ##############################
# Disable SSL warnings (not recommended for production)
urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
#######################################################################################


# Load Akamai API credentials from ~/.edgerc file
# The .edgerc file contains authentication details for the Akamai API
edgerc = EdgeRc('~/.edgerc')
section = 'default'  # Using the 'default' section from .edgerc
# base_url = f"https://{edgerc.get(section, 'host')}"  # Construct the base URL

host = edgerc.get(section, 'host')  # e.g. "hostname"
url = f"https://{host}/api-definitions/v2/endpoints"

# Load environment variables from .env file
load_dotenv()

# Default parameters for API requests
params = {
    'contractId': os.getenv('AKAMAI_CONTRACT_ID'),  # Your Akamai contract ID from .env
    'groupId': os.getenv('AKAMAI_GROUP_ID'),        # Your Akamai group ID from .env
}

headers = {"accept": "application/json"}

# Create a requests Session and attach EdgeGrid authentication so Authorization header is sent
session = requests.Session()
# Use the helper to populate auth from ~/.edgerc; this ensures the Authorization header is included
session.auth = EdgeGridAuth.from_edgerc(edgerc, section)

# Use the constructed base_url as the request URL (adjust the path if you need a specific endpoint)
# url = base_url + "/api-definitions/v2/endpoints"  # e.g. url = f"{base_url}/papi/v1/search" for a specific PAPI endpoint
params = {
    'contains': 'homedepot.ca'
}
def summarize_api_endpoints(api_json):
    """
    api_json: dict loaded from your posted JSON
    returns: list of { apiEndPointName, apiEndPointHosts, resourcePaths }
    """
    out = []
    for ep in api_json.get("apiEndPoints", []):
        out.append({
            "apiEndPointName": ep.get("apiEndPointName", ""),
            "apiEndPointHosts": ep.get("apiEndPointHosts", []) or [],
            "resourcePaths": [
                r.get("resourcePath")
                for r in (ep.get("apiResourceBaseInfo", []) or [])
                if isinstance(r, dict) and r.get("resourcePath")
            ]
        })
    return out

response = session.get(url, headers=headers, params=params, verify=False)

print(f"HTTP {response.status_code} {response.reason}")
content_type = response.headers.get('Content-Type', '')
parsed = None

if 'application/json' in content_type:
    try:
        parsed = response.json()
        print(json.dumps(parsed, indent=2, ensure_ascii=False))
    except ValueError:
        print("Failed to parse JSON; raw body:")
        print(response.text)
else:
    # Try to pretty-print JSON even if Content-Type is missing/incorrect
    try:
        parsed = json.loads(response.text)
        print(json.dumps(parsed, indent=2, ensure_ascii=False))
    except Exception:
        print("Response body:")
        print(response.text)

# If we have a parsed JSON object, produce and print a summary of API endpoints
if isinstance(parsed, dict):
    summary = summarize_api_endpoints(parsed)
    print("\nAPI endpoints summary:")
    print(json.dumps(summary, indent=2, ensure_ascii=False))