Synup
Crear clave
v1Recursos/AEO/getObtener el historial de comprobaciones de un prompt seguido

Obtener el historial de comprobaciones de un prompt seguido

Devuelve, de la más reciente a la más antigua, las comprobaciones que capturaron este prompt entre las 100 comprobaciones más recientes del sitio web: la redacción que midió cada una, su estado y las respuestas de esa redacción por motor. Solo se listan comprobaciones — una redacción que se guardó pero nunca se comprobó no aparece — y las redacciones anteriores siguen listadas tras una edición o eliminación. Solo lectura. Un prompt que ninguna comprobación capturó devuelve una lista vacía.

get/api/v1/aeo/prompts/{promptId}/history
aeo:read
Parámetros de consulta
promptIdstringobligatorio
El id del prompt seguido.
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.
Respuesta
dataobjectopcional
promptIdstringopcional
El id del prompt seguido.
checksarray of objectopcional
Las comprobaciones que capturaron este prompt, de la más reciente a la más antigua, entre las 100 comprobaciones más recientes del sitio web.
collectionIdstringopcional
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.
wordingVersionintegeropcional
La versión de la redacción: 1 al crearse, una más tras cada cambio de redacción. Devuélvela como expectedWordingVersion.
textstringopcional
La redacción del prompt. En una comprobación o una entrada del historial, la redacción que midió esa comprobación.
observationsarray of objectopcional
promptIdstringopcional
El id del prompt seguido.
wordingVersionintegeropcional
La versión de la redacción: 1 al crearse, una más tras cada cambio de redacción. Devuélvela como expectedWordingVersion.
promptTextstringopcional
La redacción del prompt. En una comprobación o una entrada del historial, la redacción que midió esa comprobación.
enginestringopcional
El motor de IA que respondió.
outcomestring (measured | unusable | failed)opcional
measured (una respuesta utilizable), unusable (el motor respondió, pero la respuesta no se pudo evaluar) o failed (sin respuesta). Solo measured es un resultado; los demás nunca se leen como cero.
mentionedbooleanopcional
Si el negocio se mencionó en la respuesta.
ranknumberopcional
La posición del negocio entre las menciones, o null si no se mencionó o no tuvo posición.
scorenumberopcional
Puntuación derivada de la posición para esta respuesta, 0-100, o null si no la hay.
answerExcerptstringopcional
Un extracto de la respuesta del motor, o null si no se conservó ninguno.
enginesarray of stringopcional
Los motores de IA seleccionados para esta comprobación.
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/{promptId}/history
Su clave de API
promptId *
locationId *
{}

Guías que usan este recurso