Pular para o conteúdo principal

​
1. Obtenha sua chave de API

Faça login no Painel do DeepXL e crie uma chave de API na seção Chaves de API.

​
2. Detecte fraude em documentos

Envie um arquivo para o Modelo de Documentos para verificar se houve manipulação: 
curl -X POST https://api.deepxl.ai/v1/detection \
  -H "x-api-key: YOUR_API_KEY" \
  -F "model=document" \
  -F "file=@bank_statement.pdf" \
  -F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-001","companyName":"DeepXL","companyId":"COMP-001"}'
Você receberá uma resposta com uma pontuação de probabilidade de fraude (0–100%), nível de gravidade (low, medium, high), classificação de qualidade (verified, unverified, rejected) e justificativa detalhada: 
{
  "result": {
    "detectionId": 42,
    "mediaType": "document",
    "fileType": "pdf",
    "fileName": "bank_statement.pdf",
    "fileSize": 245678,
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "model": "document",
    "modelVersion": "1.1.0",
    "likelihood": 15.5,
    "fraudSeverity": "low",
    "classification": "verified",
    "reasoning": [
      "Document structure appears authentic",
      "No manipulation detected"
    ],
    "modelResults": {
      "technicalChecks": [
        { "type": "DOCUMENT_CLASSIFIER", "status": "PASS", "details": "Classified as bank statement", "likelihood": 0.0 },
        { "type": "SEMANTIC_QUALITY", "status": "PASS", "details": "Image quality is acceptable", "likelihood": 0.0 },
        { "type": "SEMANTIC_FRAUD", "status": "PASS", "details": "No tampering indicators found", "likelihood": 0.0 }
      ]
    },
    "files": [
      {
        "category": "original_file",
        "fileName": "fd_42_bank_statement.pdf",
        "url": "https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf"
      }
    ]
  }
}

​
3. Extraia dados de um documento

Use o Modelo de Parsing para extrair dados estruturados de um documento de identidade: 
curl -X POST https://api.deepxl.ai/v1/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -F "model=light" \
  -F "file=@drivers_license.jpg"

{
  "result": {
    "parseId": 117,
    "mediaType": "image",
    "fileType": "jpeg",
    "fileName": "drivers_license.jpg",
    "fileSize": 231433,
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "model": "light",
    "modelVersion": "1.2.0",
    "documentType": "idDocument",
    "parsedData": {
      "firstName": "JOHN",
      "lastName": "DOE",
      "dateOfBirth": "1990-05-15",
      "licenseNumber": "D1234567",
      "expirationDate": "2028-05-15",
      "address": "123 MAIN ST ANYTOWN, CA 90210"
    },
    "files": [
      {
        "category": "original_file",
        "fileName": "drivers_license.jpg",
        "url": "https://api.deepxl.ai/v1/files/parse_117_drivers_license.jpg"
      }
    ]
  }
}

​
4. Verifique a identidade

Use o Modelo ID-Selfie para comparar o documento de identidade de uma pessoa com sua selfie: 
curl -X POST https://api.deepxl.ai/v1/verification \
  -H "x-api-key: YOUR_API_KEY" \
  -F "idFile=@passport.jpg" \
  -F "selfieFile=@selfie.jpg"

{
  "result": {
    "verificationId": 457,
    "idFileName": "passport.jpg",
    "selfieFileName": "selfie.jpg",
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "model": "verification",
    "modelVersion": "1.0.0",
    "verified": true,
    "modelResults": {
      "technicalChecks": [
        {
          "checkType": "face_detection",
          "likelihood": 99.85,
          "faceCount": { "id": 1, "selfie": 1 },
          "idFaces": [
            { "faceId": "face_1", "detectionConfidence": 0.9992 }
          ],
          "selfieFaces": [
            { "faceId": "face_1", "detectionConfidence": 0.9985 }
          ]
        }
      ]
    },
    "files": [
      {
        "category": "id",
        "fileName": "passport.jpg",
        "url": "https://api.deepxl.ai/v1/files/v_id_457_passport.jpg"
      },
      {
        "category": "face",
        "fileName": "selfie.jpg",
        "url": "https://api.deepxl.ai/v1/files/v_face_457_selfie.jpg"
      }
    ]
  }
}

​
Próximos passos

Autenticação

Saiba mais sobre autenticação com chave de API e token Bearer.

Guia de detecção de fraude

Modelos de Documentos e de Objetos, pontuações de probabilidade e filtragem.