Method get_user_activity

src/openrouter/analytics.py:15–157

r"""Get user activity grouped by endpoint Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. [Management key](/docs/guides/overview/auth/management-api-keys) required. :param http_referer: The app identifier should be your app's URL and is used as

(
        self,
        *,
        http_referer: Optional[str] = None,
        x_open_router_title: Optional[str] = None,
        x_open_router_categories: Optional[str] = None,
        date_: Optional[str] = None,
        api_key_hash: Optional[str] = None,
        user_id: Optional[str] = None,
        retries: OptionalNullable[utils.RetryConfig] = UNSET,
        server_url: Optional[str] = None,
        timeout_ms: Optional[int] = None,
        http_headers: Optional[Mapping[str, str]] = None,
    )

    r"""Analytics and usage endpoints"""

    def get_user_activity(
        self,
        *,
        http_referer: Optional[str] = None,
        x_open_router_title: Optional[str] = None,
        x_open_router_categories: Optional[str] = None,
        date_: Optional[str] = None,
        api_key_hash: Optional[str] = None,
        user_id: Optional[str] = None,
        retries: OptionalNullable[utils.RetryConfig] = UNSET,
        server_url: Optional[str] = None,
        timeout_ms: Optional[int] = None,
        http_headers: Optional[Mapping[str, str]] = None,
    ) -> components.ActivityResponse:
        r"""Get user activity grouped by endpoint

        Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. [Management key](/docs/guides/overview/auth/management-api-keys) required.

        :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
            This is used to track API usage per application.

        :param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.

        :param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.

        :param date_: Filter by a single UTC date in the last 30 days (YYYY-MM-DD format).
        :param api_key_hash: Filter by API key hash (SHA-256 hex string, as returned by the keys API).
        :param user_id: Filter by org member user ID. Only applicable for organization accounts.
        :param retries: Override the default retry configuration for this method
        :param server_url: Override the default server URL for this method
        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
        :param http_headers: Additional headers to set or replace on requests.
        """
        base_url = None
        url_variables = None
        if timeout_ms is None:
            timeout_ms = self.sdk_configuration.timeout_ms

        if server_url is not None:
            base_url = server_url
        else:
            base_url = self._get_url(base_url, url_variables)

        request = operations.GetUserActivityRequest(
            http_referer=http_referer,
            x_open_router_title=x_open_router_title,
            x_open_router_categories=x_open_router_categories,
            date_=date_,
            api_key_hash=api_key_hash,
            user_id=user_id,
        )

        req = self._build_request(
            method="GET",
            path="/activity",
            base_url=base_url,
            url_variables=url_variables,
            request=request,