API Documentation V3.1

POST /documents/recognize Content-Type: multipart/form-data

{
  "validity_status": "valid",  // valid, expired, fake, unknown
  "checks": {
     "id_checksum": true,      // Контрольная сумма личного номера (Mod-10) совпадает
     "mrz_valid": true,        // MRZ соответствует данным на странице
     "expiry_check": true,     // Документ не просрочен
     "age_check": true         // Владельцу есть 18 лет
  },
  "quality": {
     "is_good": true,
     "blur_score": 0.05,       // Уровень размытия (0.0 - нет, 1.0 - сильно)
     "glare_detected": false   // Блики
  }
}

PYTHON

import requests

API_KEY = "sk-pragma-..."
URL = "https://ocr-api.pragma.by/v1/documents/recognize"

def recognize_doc(filepath):
    with open(filepath, 'rb') as f:
        response = requests.post(
            URL,
            headers={"X-API-Key": API_KEY},
            files={"file": f},
            data={
                "document_type": "passport",
                "ocr_provider": "gemini"  # Explicitly use Gemini 3.0
            }
        )
    return response.json()

result = recognize_doc("passport_scan.jpg")
print(f"Name: {result['data']['result']['fields']['file_name']}")

NODE.JS

const axios = require('axios');
const fs = require('fs');
const FormData = require('form-data');

async function scanDocument() {
  const form = new FormData();
  form.append('file', fs.createReadStream('passport.jpg'));
  form.append('ocr_provider', 'anthropic'); // Use Claude 4.5

  try {
    const res = await axios.post(
      'https://ocr-api.pragma.by/v1/documents/recognize', 
      form, 
      {
        headers: { 
          'X-API-Key': 'YOUR_KEY',
          ...form.getHeaders()
        }
      }
    );
    console.log(res.data);
  } catch (err) {
    console.error(err.response ? err.response.data : err.message);
  }
}

PHP

$client = new \GuzzleHttp\Client();

$response = $client->post('https://ocr-api.pragma.by/v1/documents/recognize', [
    'headers' => [
        'X-API-Key' => 'YOUR_KEY'
    ],
    'multipart' => [
        [
            'name'     => 'file',
            'contents' => fopen('passport.jpg', 'r')
        ],
        [
            'name'     => 'ocr_provider',
            'contents' => 'gemini'
        ]
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);

JAVA

OkHttpClient client = new OkHttpClient();

RequestBody requestBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", "passport.jpg",
        RequestBody.create(new File("passport.jpg"), MediaType.parse("image/jpeg")))
    .addFormDataPart("ocr_provider", "google_vision") // Using Legacy Vision
    .build();

Request request = new Request.Builder()
    .url("https://ocr-api.pragma.by/v1/documents/recognize")
    .addHeader("X-API-Key", "YOUR_KEY")
    .post(requestBody)
    .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

C# / .NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "YOUR_KEY");

using var content = new MultipartFormDataContent();
using var fileStream = File.OpenRead("passport.jpg");
content.Add(new StreamContent(fileStream), "file", "passport.jpg");
content.Add(new StringContent("qwen"), "ocr_provider");

var response = await client.PostAsync("https://ocr-api.pragma.by/v1/documents/recognize", content);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

{
  "event": "document.completed",
  "request_id": "550e8400-...",
  "timestamp": "2026-02-15T10:00:00Z",
  "payload": {
    "status": "completed",
    "result": { ... } // Полный объект результата
  },
  "signature": "hmac-sha256=..." // Для проверки подлинности
}