Detección de fraude documental API

Introducción API

La tecnología de Inteligencia Artificial especializada en detección de falsificación de imágenes se ha vuelto más fácil que nunca usando la API de ImgAuth.com. Con solo unas pocas líneas de código, puede llevar esta tecnología a su aplicación.

Parámetros de Solicitud: Datos de imagen codificados en Base64 y luego URL-encodeados. Máximo 10 MB. Lado más corto de al menos 512 px y lado más largo de como máximo 8192 px. Soporta jpg/jpeg/png/bmp. Proporcione image o url.
Parámetros de respuesta: Referencia de los campos de respuesta de la API

Introducción API

equipos financieros revisando facturas y recibos
RR. HH. revisando certificados y registros escaneados
aseguradoras revisando documentos de reclamación

Autenticación

Sustituye {your-api-domain} por el endpoint de API mostrado en el panel de tu cuenta.

Autentica las solicitudes con el endpoint de API de tu cuenta y un token Bearer. Después de comprar créditos de API, puedes ver tu endpoint y token en el panel de tu cuenta. Mantén tu token en secreto y nunca lo subas a repositorios públicos.

POSThttps://api.imgauth.com/v1/document-fraud-detection

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

Parámetros de Solicitud

Parámetro	Tipo	✓	Descripción
image	string	✓	Datos de imagen codificados en Base64 y luego URL-encodeados. Máximo 10 MB. Lado más corto de al menos 512 px y lado más largo de como máximo 8192 px. Soporta jpg/jpeg/png/bmp. Proporcione image o url.
detect_proportion	boolean	—	Indica si se devuelve la puntuación de confianza de manipulación. Valor predeterminado: false. true devuelve la puntuación, false la omite.
return_heatmap	boolean	—	Indica si se devuelve un heatmap de falsificación. Valor predeterminado: false. true devuelve un heatmap en Base64, false lo omite.
location	boolean	—	Use estos ejemplos para construir y depurar su integración

Ejemplo de Solicitud HTTP

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "detect_proportion": true,
  "return_heatmap": true,
  "location": true
}

Parámetros de respuesta

Parámetro	Tipo	Descripción
code	integer	Referencia para códigos de respuesta API
request_id	string	Use estos ejemplos para construir y depurar su integración
data.detection_result	"fake" \| "real"	Resultado de manipulación: "fake" significa que se detectó manipulación y "real" significa que no se detectó manipulación.
data.tampered_proportion	number \| null	Puntuación de confianza de manipulación, devuelta cuando detect_proportion = true.
data.heatmap	string \| null	Heatmap Base64 de las regiones manipuladas, devuelto cuando return_heatmap = true.
data.tampered_location	array	Matriz de coordenadas de regiones sospechosas, devuelta cuando probability es mayor o igual que restrict_probability. Cada elemento incluye left, top, width, height y probability.

Ejemplos de Respuesta

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "detection_result": "fake",
    "tampered_proportion": 0.82,
    "heatmap": "<BASE64_HEATMAP>",
    "tampered_location": [
      { "left": 124, "top": 86, "width": 220, "height": 74, "probability": 0.91 }
    ]
  }
}

Códigos de Error

400INVALID_REQUESTLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

401INVALID_API_KEYLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

402CREDITS_EXHAUSTEDLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

403API_KEY_INACTIVE / API_KEY_EXPIREDLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

413PAYLOAD_TOO_LARGELos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

415UNSUPPORTED_IMAGELos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

502UPSTREAM_ERRORLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

504UPSTREAM_TIMEOUTLos API messages se muestran con sus valores brutos del servicio ascendente para coincidir exactamente con las respuestas de producción.

Ejemplos de Código

curl -X POST "https://api.imgauth.com/v1/document-fraud-detection" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
  "detect_proportion": true,
  "return_heatmap": true,
  "location": true
}'