# getSitePageNudgeStats Source: Locale: ru releaseGitSha: 45cdd4e19c6d3956d1bfa48c79fcb8dfec11fa9e sourceContentDigest: ac44545bea30f0ce6612173e3b8a3f5fe52d9da15e18323af665f3965a9e0345 Version: 1 # getSitePageNudgeStats `GET /api/v1/tools/site/pages/{seqNum}/nudge/stats` Read the nudge funnel of one site page ## Авторизация и права Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL. | Поле | Значение | | - | - | | security.0.hubApiKey | \[] | | security.1.hubBearer | \[] | | securitySchemes.hubApiKey.in | "header" | | securitySchemes.hubApiKey.name | "X-Api-Key" | | securitySchemes.hubApiKey.type | "apiKey" | | securitySchemes.hubBearer.scheme | "bearer" | | securitySchemes.hubBearer.type | "http" | | x-required-scopes | \["site:read"] | ## Параметры запроса | Поле | Значение | | - | - | | 0.in | "path" | | 0.name | "seqNum" | | 0.required | true | | 0.schema | [0.schema](https://telegafirst.com/docs/schema-1530eae3d9b69eb0d4bf2268a4cc47372fcec06f1cf1736785dd6f16848382fc) | | 1.in | "query" | | 1.name | "from" | | 1.required | false | | 1.schema | [1.schema](https://telegafirst.com/docs/schema-4f410cd74c87d8ddd21f20e835e06ed7445481c3aeae3c12085e82c54ea2fb7d) | | 2.in | "query" | | 2.name | "to" | | 2.required | false | | 2.schema | [2.schema](https://telegafirst.com/docs/schema-4f410cd74c87d8ddd21f20e835e06ed7445481c3aeae3c12085e82c54ea2fb7d) | ## Тело запроса | Поле | Значение | | - | - | | Тело запроса | null | ## Ответы | Поле | Значение | | - | - | | 200.content.application/json.schema | [SiteNudgeStats](https://telegafirst.com/docs/schema-d6ed57b3334486315e24436ab2d19c3f72ad08deca9fcafd787273d1bf16b6e3) | | 200.description | "Tenant site control-plane result" | | 200.headers.X-Bot-Username.description | "Active bot username, when resolved" | | 200.headers.X-Bot-Username.schema | [200.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-Client-Slug.description | "Active tenant slug, when resolved" | | 200.headers.X-Client-Slug.schema | [200.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-RateLimit-Limit.description | "Effective request budget" | | 200.headers.X-RateLimit-Limit.schema | [200.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-RateLimit-Remaining.description | "Remaining request budget" | | 200.headers.X-RateLimit-Remaining.schema | [200.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-RateLimit-Reset.description | "Unix window reset in seconds" | | 200.headers.X-RateLimit-Reset.schema | [200.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | ## Ошибки | Поле | Значение | | - | - | | 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 400.description | "Page seq\_num is not a canonical positive int4, or from/to is not an ISO-8601 instant" | | 400.x-error-codes | \["VALIDATION\_ERROR"] | | 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 401.description | "Missing, invalid, revoked or conflicting credential; surface JWT is refused" | | 401.x-error-codes | \["INVALID\_API\_KEY"] | | 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 403.description | "Missing scope, prohibited publishable credential or absent active bot" | | 403.x-error-codes | \["INSUFFICIENT\_SCOPE","PUBLISHABLE\_KEY\_NOT\_ALLOWED","NO\_ACTIVE\_BOT"] | | 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 413.description | "Resource policy size or item-count limit exceeded" | | 413.x-error-codes | \["PAYLOAD\_TOO\_LARGE","ITEM\_COUNT\_EXCEEDED"] | | 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 422.description | "Only a seqNum that matches no page of the tenant is refused (an unpublished or hidden page is still read); or the window is empty (from is not before to)" | | 422.x-error-codes | \["SITE\_NUDGE\_PAGE\_NOT\_ELIGIBLE","INVALID\_INPUT"] | | 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 429.description | "Resource rate budget exceeded or unavailable" | | 429.headers.Retry-After.description | "Retry delay in seconds, when supplied by the limiter" | | 429.headers.Retry-After.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.x-error-codes | \["RATE\_LIMIT\_EXCEEDED","RATE\_LIMIT\_UNAVAILABLE"] | | 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 500.description | "Unexpected internal failure" | | 500.x-error-codes | \["INTERNAL\_ERROR"] | ## Дополнительные условия | Поле | Значение | | - | - | | description | "site:read. The funnel over the half-open window \[from, to) (ISO-8601 instants; default the last 30 days ending now): visits (mini-app opens of the page), cooldownVisits (opens inside the 30-day cooldown), waits started, pending (still waiting), goalBeforeFire (reached a goal before the timer, no nudge sent), fired, goalAfterFire (fired waits whose person reached a goal afterwards), superseded (replaced by a wait on another page, or cancelled because the nudge was turned off or the page hidden or unpublished), failed (the timer fired and the channel refused), plus stepOutcomes and aiOutcomes of waits whose timer fired (fired or failed; superseded excluded). A page that is unpublished or hidden can still be read." | | operationId | "getSitePageNudgeStats" | | summary | "Read the nudge funnel of one site page" | | tags | \["site"] | | x-idempotency.conflictStatus | null | | x-idempotency.implementation | "none" | | x-idempotency.replayStatus | null | | x-idempotency.required | false | | x-idempotency.scope | \[] | | x-idempotency.ttlSeconds | null | | x-pagination.queryParameters | \[] | | x-pagination.supported | false | | x-scope-semantics | "ALL" |