Synup
Criar chave
v1Recursos/AEO/getObter o histórico de verificações de um prompt monitorado

Obter o histórico de verificações de um prompt monitorado

Retorna, da mais recente para a mais antiga, as verificações que capturaram este prompt entre as 100 verificações mais recentes do site: o texto que cada uma mediu, seu status e as respostas desse texto por mecanismo. Só verificações são listadas — um texto salvo mas nunca verificado não aparece — e os textos anteriores continuam listados após uma edição ou remoção. Somente leitura. Um prompt que nenhuma verificação capturou retorna uma lista vazia.

get/api/v1/aeo/prompts/{promptId}/history
aeo:read
Parâmetros de consulta
promptIdstringobrigatório
O id do prompt monitorado.
locationIdstringobrigatório
O id de local da entidade de site. Um site que você não pode ver, ou que não existe, retorna 404; um local físico retorna 422 entity_type_not_supported.
Resposta
dataobjectopcional
promptIdstringopcional
O id do prompt monitorado.
checksarray of objectopcional
As verificações que capturaram este prompt, da mais recente para a mais antiga, entre as 100 verificações mais recentes do site.
collectionIdstringopcional
Identificador único da verificação.
capturedAtstringopcional
Quando a verificação capturou os prompts que mede, como carimbo de data/hora ISO 8601.
settledAtstringopcional
Quando a verificação terminou, ou null enquanto ainda está em andamento.
statusstring (captured | running | complete | partial | failed | held)opcional
captured, running, complete, partial (faltam algumas respostas), failed ou held (o resultado é desconhecido e precisa de conciliação; nem concluída nem com falha). Uma verificação failed ou held pode ter parado antes de solicitar todas as respostas esperadas.
wordingVersionintegeropcional
A versão do texto: 1 ao ser criado, uma a mais após cada alteração de texto. Envie-a de volta como expectedWordingVersion.
textstringopcional
O texto do prompt. Em uma verificação ou entrada de histórico, o texto que essa verificação mediu.
observationsarray of objectopcional
promptIdstringopcional
O id do prompt monitorado.
wordingVersionintegeropcional
A versão do texto: 1 ao ser criado, uma a mais após cada alteração de texto. Envie-a de volta como expectedWordingVersion.
promptTextstringopcional
O texto do prompt. Em uma verificação ou entrada de histórico, o texto que essa verificação mediu.
enginestringopcional
O mecanismo de IA que respondeu.
outcomestring (measured | unusable | failed)opcional
measured (uma resposta aproveitável), unusable (o mecanismo respondeu, mas a resposta não pôde ser avaliada) ou failed (sem resposta). Só measured é um resultado; os demais nunca são lidos como zero.
mentionedbooleanopcional
Se a empresa foi mencionada na resposta.
ranknumberopcional
A posição da empresa entre as menções, ou null quando ela não foi mencionada nem classificada.
scorenumberopcional
Pontuação derivada da posição para esta resposta, 0-100, ou null quando não há.
answerExcerptstringopcional
Um trecho da resposta do mecanismo, ou null quando nenhum foi guardado.
enginesarray of stringopcional
Os mecanismos de IA selecionados para esta verificação.
Erros
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
503O serviço está temporariamente indisponível. Siga as orientações de nova tentativa para esta operação.
get/api/v1/aeo/prompts/{promptId}/history
Sua chave de API
promptId *
locationId *
{}

Guias que usam este recurso