Esquema común

Todos los puntos finales de la API Annie Insights comparten parámetros de solicitud y patrones de respuesta comunes.

Parámetros de solicitud estándar

Cada punto final basado en imágenes requiere estos tres parámetros:

Parámetro	Tipo	Requerido	Descripción
PatientID	cadena	✅ Sí	Identificador de paciente único de su sistema
TimeStamp	cadena	✅ Sí	Marca de tiempo de la sesión de análisis (por ejemplo, "2026-05-24")
ImageName	cadena	✅ Sí	URL completa a la imagen dental a analizar

Ejemplo de cuerpo de solicitud

{
  "PatientID": "P-001",
  "TimeStamp": "2026-05-24",
  "ImageName": "https://your-storage.com/images/patient-photo.jpg"
}

Requisitos de URL de imagen

• Debe ser una URL HTTPS de acceso público
• Formatos soportados: JPEG, PNG
• Tamaño máximo de archivo: 20 MB
• Resolución recomendada: 1024×768 o superior

Campos de respuesta estándar

Campo	Tipo	Descripción
Version	cadena	Versión de API utilizada para el procesamiento
PatientID	cadena	Se hizo eco de la solicitud
TimeStamp	cadena	Se hizo eco de la solicitud
ImageName	cadena	Nombre de archivo de imagen procesada
Results	objeto	Resultados de análisis específicos de endpoints
OutputImageUrl	cadena	URL de imagen anotada (protegida por SAS, vencimiento a las 72 h)

Parámetros opcionales

Algunos puntos finales aceptan parámetros opcionales adicionales:

Parámetro	Tipo	Disponible en	Descripción
StandardName	cadena	Segmentación frontal	Estándar de evaluación (predeterminado: "ICON")
PlotLabels	booleano	Segmentación frontal	Mostrar etiquetas de clasificación en la salida
DrawContours	booleano	Puntos finales de segmentación	Dibujar contornos en la salida