FormRead 서버 측 처리 API

서버 측 양식 처리

FormRead 서버 측 API를 사용하면 스캔된 양식 이미지를 보내고 구조화된 결과(OMR, OCR, BCR)를 JSON으로 직접 받을 수 있습니다. 브라우저나 iframe 없이 백엔드에서 당사로 간단한 HTTP 요청만 하면 됩니다.

• 이미지를 보내면 단일 요청으로 결과를 JSON으로 받습니다.
• OMR(버블 감지), OCR(텍스트 추출), BCR(바코드/QR 읽기) 지원
• 양식 구성은 대시보드에서 설정한 양식에서 자동으로 로드됩니다.

인증

엔터프라이즈 사용의 경우 Bearer Auth 토큰을 생성하여 API를 사용할 수 있습니다.

FormRead 대시보드에 로그인하여 API 토큰 옵션에 접근하세요:

타사 서비스가 귀하를 대신하여 저희 애플리케이션에 인증할 수 있도록 API 토큰을 생성하세요:

양식 이미지 처리

처리할 스캔된 양식 이미지를 보냅니다. 양식은 대시보드 또는 iframe을 통해 읽기 영역(OMR, OCR, BCR)이 이미 설정되어 있어야 합니다. API는 저장된 양식 구성을 사용하여 이미지를 처리합니다.

헤더

파일 업로드 사용 시:

curl --location 'https://formread.org/api/forms/123/process' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --form 'image=@"/path/to/scanned-form.jpg"'

이미지 URL 사용 시:

curl --location 'https://formread.org/api/forms/123/process' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"image_url": "https://example.com/scanned-form.jpg"}'

응답

{
  "success": true,
  "results": {
    "OMR-0-0": "A",
    "OMR-0-1": "C",
    "OMR-0-2": "B,D",
    "OCR-1": "John Smith",
    "BCR-2": "1234567890"
  },
  "omr_details": {
    "OMR-0": {
      "questions": [
        [
          {"left": 0.12, "top": 0.22, "width": 0.02, "height": 0.02, "blackPixelsRatio": 0.72},
          {"left": 0.15, "top": 0.22, "width": 0.02, "height": 0.02, "blackPixelsRatio": 0.15}
        ]
      ]
    }
  },
  "anchor_error": false,
  "processing_time_ms": 450
}

응답 필드

이미지 입력 옵션

이미지를 세 가지 방법으로 제공할 수 있습니다. 정확히 하나를 사용하세요:

일괄 처리

하나의 요청으로 동일한 양식의 여러 이미지를 처리하려면 image_url 필드에 쉼표로 구분된 URL 목록을 전달하십시오. 결과는 동일한 순서의 배열로 반환됩니다.

요청

curl --location 'https://formread.org/api/forms/123/process' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"image_url": "https://example.com/a.jpg,https://example.com/b.jpg,https://example.com/c.jpg"}'

응답

{
  "results": [
    {
      "id": "0",
      "image_url": "https://example.com/a.jpg",
      "success": true,
      "results": { "OMR-0-0": "A", "OCR-1": "John Smith" },
      "anchor_error": false,
      "processing_time_ms": 430
    },
    {
      "id": "1",
      "image_url": "https://example.com/b.jpg",
      "success": true,
      "results": { "OMR-0-0": "B", "OCR-1": "Jane Doe" }
    },
    {
      "id": "2",
      "image_url": "https://example.com/c.jpg",
      "success": false,
      "error": "Failed to fetch image from URL: 404"
    }
  ],
  "total": 3
}

일괄 매개변수

omr_details를 포함한 일괄 처리

curl --location 'https://formread.org/api/forms/123/process' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_url": "https://example.com/a.jpg,https://example.com/b.jpg",
    "details": true
  }'

제한 사항

429 응답은 다음과 같습니다:

{
  "message": "Too Many Attempts."
}

일괄 요청은 포함된 URL 수에 관계없이 한 번의 호출로 간주됩니다.

지원되는 영역 유형

코드 예제

양식 이미지 처리를 위한 Python 및 JavaScript의 전체 예제는 다음과 같습니다:

Python

import requests

API_URL = "https://formread.org/api/forms/{form_id}/process"
TOKEN = "YOUR_API_TOKEN"

with open("scanned-form.jpg", "rb") as f:
    response = requests.post(
        API_URL.format(form_id=123),
        headers={
            "Accept": "application/json",
            "Authorization": f"Bearer {TOKEN}",
        },
        files={"image": f},
    )

data = response.json()
print(data["results"])
# {"OMR-0-0": "A", "OMR-0-1": "C", "OCR-1": "John Smith"}

Node.js

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

const form = new FormData();
form.append('image', fs.createReadStream('scanned-form.jpg'));

const response = await axios.post(
  'https://formread.org/api/forms/123/process',
  form,
  {
    headers: {
      ...form.getHeaders(),
      'Accept': 'application/json',
      'Authorization': 'Bearer YOUR_API_TOKEN',
    },
  }
);

console.log(response.data.results);
// { 'OMR-0-0': 'A', 'OMR-0-1': 'C', 'OCR-1': 'John Smith' }

자주 묻는 질문