Synup
Crear clave
v1Recursos/AEO/getListar las comprobaciones de prompts de un sitio web

Listar las comprobaciones de prompts de un sitio web

Devuelve las comprobaciones de prompts del sitio web, de la más reciente a la más antigua, sin sus respuestas: cuándo se capturó y se cerró cada una, su estado, la revisión del conjunto y los motores que midió, y cuántas respuestas fueron utilizables. Un informe archivado de antes de que se gestionaran los prompts aparece con source legacy_report. Solo lectura: listar nunca inicia una comprobación.

get/api/v1/aeo/prompts/checks
aeo:read
Parámetros de consulta
locationIdstringobligatorio
El id de ubicación de la entidad de sitio web. Un sitio web que no puedes ver, o que no existe, devuelve 404; una ubicación física devuelve 422 entity_type_not_supported.
limitintegeropcional
Cuántas comprobaciones devolver, de la más reciente a la más antigua: de 1 a 100, 24 por defecto. Los valores fuera de ese rango se ajustan al límite.
Respuesta
dataarray of objectopcional
idstringopcional
Identificador único de la comprobación.
capturedAtstringopcional
Cuándo capturó la comprobación los prompts que mide, como marca de tiempo ISO 8601.
settledAtstringopcional
Cuándo terminó la comprobación, o null mientras sigue en curso.
statusstring (captured | running | complete | partial | failed | held)opcional
captured, running, complete, partial (faltan algunas respuestas), failed o held (el resultado es desconocido y necesita conciliación; ni completada ni fallida). Una comprobación failed o held puede haberse detenido antes de solicitar todas las respuestas esperadas.
promptSetRevisionintegeropcional
La revisión del conjunto que capturó la comprobación.
promptCountintegeropcional
Cuántos prompts capturó la comprobación.
enginesarray of stringopcional
Los motores de IA seleccionados para esta comprobación.
measuredintegeropcional
Cuántas respuestas fueron utilizables.
expectedintegeropcional
Cuántas respuestas se esperaban de los prompts y motores capturados.
publicationstring (published | superseded)opcional
published cuando los resultados de la comprobación pasaron a ser el informe del sitio web, superseded cuando un resultado más reciente ya había ocupado su lugar, o null.
sourcestring (legacy_report)opcional
legacy_report en un informe archivado de antes de que se gestionaran los prompts; ausente en una comprobación de prompts.
legacyEnginesarray of objectopcional
Solo informes heredados archivados: la puntuación de cada motor y sus cantidades de prompts medidos y esperados tal como el informe los guardó. Un valor que no guardó es null, nunca cero.
enginestringopcional
scorenumberopcional
measuredPromptsintegeropcional
expectedPromptsintegeropcional
Errores
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503El servicio no está disponible temporalmente. Siga las indicaciones de reintento para esta operación.
get/api/v1/aeo/prompts/checks
Su clave de API
locationId *
limit
{}

Guías que usan este recurso