ميزة Pro

هذه الميزة متاحة فقط لمستخدمي Pro. قم بالترقية إلى Pro للوصول إلى هذه الأدوات القوية والعديد من الأدوات الأخرى.

مسح API

المسح عبر API ميزة معالجة عن بُعد من Look Scanned. ارفع ملف PDF لإنشاء مهمة مسح، ثم استخدم استدعاءات API بسيطة للتحقق من حالتها وجلب نسخة واقعية ممسوحة ضوئيًا؛ لذا فهي مناسبة للأتمتة والتكامل البرمجي. يمكن تخصيص اللون والضوضاء والتمويه والحدود وزوايا الدوران، كما تعمل مع بيئات التطوير ولغات البرمجة الشائعة لتسهيل دمج وظائف Look Scanned الأساسية في التطبيقات أو الخدمات.

API Bearer Token

أمثلة التعليمات البرمجية

TypeScriptPythoncURL

interface ScanConfig {
  rotate?: number                // degrees to rotate the document
  rotate_var?: number            // degrees to rotate the document randomly
  colorspace?: 'gray' | 'sRGB'   // the colorspace of the output image
  blur?: number                  // the amount of blur to apply to the image
  noise?: number                 // the amount of noise to apply to the image
  border?: boolean               // whether to add a border to the image
  brightness?: number            // the brightness of the image. 1 is no change
  contrast?: number              // the contrast of the image. 1 is no change
  resolution?: number            // the resolution of the image in DPI
  output_format?: 'image/png' | 'image/jpeg' // the format of the output image
}

interface ScanOptions {
  config: ScanConfig
  webhookUrl?: string        // webhook URL to notify when job is completed
}

interface ScanResponse {
  jobID: string              // UUID of the scan job
  userID: string             // UUID of the user who created the job
  createdAt: number          // timestamp of job creation
  status: 'pending' | 'processing' | 'completed' | 'failed'
  config: ScanConfig
  inputUploadedAt?: number   // timestamp when input file was uploaded
  completedAt?: number       // timestamp when job was completed
  webhookUrl?: string        // webhook URL for notifications
  uploadURL?: string         // S3 presigned URL for file upload
  downloadURL?: string       // S3 presigned URL for file download
}

async function apiScan(pdfBlob: Blob, scanOptions: ScanOptions, token: string): Promise<ScanResponse> {
  const response = await fetch('https://api.lookscanned.io/v1/scan-jobs', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`
    },
    body: JSON.stringify(scanOptions)
  })
  const result: ScanResponse = await response.json()

  // PUT PDF Blob to upload URL
  const uploadURL = result.uploadURL
  await fetch(uploadURL, {
    method: 'PUT',
    headers: {
      'Content-Type': 'application/pdf',
      'Content-Length': pdfBlob.size.toString()
    },
    body: pdfBlob
  })
  
  // get scan job status
  const jobStatusResponse = await fetch(`https://api.lookscanned.io/v1/scan-jobs/${result.jobID}`, {
    headers: {
      'Authorization': `Bearer ${token}`
    }
  })
  return await jobStatusResponse.json()
}

import requests

def api_scan(pdf_file, scan_options, token):
    # Create scan job
    response = requests.post(
        'https://api.lookscanned.io/v1/scan-jobs',
        headers={'Authorization': f'Bearer {token}'},
        json=scan_options
    )
    result = response.json()

    # Upload PDF to presigned URL
    upload_url = result['uploadURL']
    requests.put(
        upload_url,
        headers={
            'Content-Type': 'application/pdf',
            'Content-Length': str(len(pdf_file))
        },
        data=pdf_file
    )
    
    # Get scan job status
    job_status = requests.get(
        f'https://api.lookscanned.io/v1/scan-jobs/{result["jobID"]}',
        headers={'Authorization': f'Bearer {token}'}
    )
    return job_status.json()

# Example usage
if __name__ == "__main__":
    with open('document.pdf', 'rb') as f:
        pdf_content = f.read()
    
    options = {
        'config': {
            # Optional parameters:
            # 'rotate': 0,              # degrees to rotate the document
            # 'colorspace': 'gray',     # gray or sRGB
            # 'resolution': 300,        # DPI
            # 'rotate_var': 0,          # random rotation variance in degrees
            # 'blur': 0,                # amount of blur
            # 'noise': 0,               # amount of noise
            # 'border': False,          # whether to add border
            # 'brightness': 1,          # 1 is no change
            # 'contrast': 1,            # 1 is no change
            # 'output_format': 'image/png'  # image/png or image/jpeg
        },
        'webhookUrl': 'https://example.com/webhook'
    }
    
    result = api_scan(pdf_content, options, 'your-api-token')
    print(f"Scan job created with ID: {result['jobID']}")

# Set your API token and PDF file as environment variables
export LOOKSCANNED_API_TOKEN='your_api_token_here'

# Create a new scan job
curl -X POST 'https://api.lookscanned.io/v1/scan-jobs' \
  -H "Authorization: Bearer ${LOOKSCANNED_API_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{
    "config": {
      "rotate": 0,
      "rotate_var": 1,
      "colorspace": "gray",
      "blur": 0.2,
      "noise": 0.1,
      "border": true,
      "brightness": 1.0,
      "contrast": 1.0,
      "resolution": 300,
      "output_format": "image/jpeg"
    },
    "webhookUrl": "https://your-domain.com/webhook"
  }'

# Response will include uploadURL and jobID
# {
#   "jobID": "550e8400-e29b-41d4-a716-446655440000",
#   "userID": "446655440000-e29b-41d4-a716-550e8400",
#   "createdAt": 1616161616,
#   "status": "created",
#   "uploadURL": "...",
#   "config": { ... }
# }

# Upload PDF file to the presigned URL
curl -X PUT 'PRESIGNED_UPLOAD_URL' \
  -H 'Content-Type: application/pdf' \
  -H "Content-Length: PDF_FILE_SIZE" \
  --data-binary "@path/to/your/file.pdf"

# Check job status
curl 'https://api.lookscanned.io/v1/scan-jobs/JOB_ID' \
  -H "Authorization: Bearer ${LOOKSCANNED_API_TOKEN}"

# Response will include status and downloadURL when completed
# {
#   "jobID": "550e8400-e29b-41d4-a716-446655440000",
#   "status": "completed",
#   "downloadURL": "...",
#   ...
# }

# Download the PDF
curl -o scanned.pdf 'DOWNLOAD_URL'

جربه

مساحة اللون

الدقة (DPI)

الدوران

تباين الدوران

التمويه

الضوضاء

السطوع

التباين

الحدود

تنسيق الإخراج

{
  "config": {
    "rotate": 1,
    "rotate_var": 0.5,
    "colorspace": "gray",
    "blur": 0,
    "noise": 0,
    "border": false,
    "brightness": 1.3,
    "contrast": 1.3,
    "resolution": 150,
    "output_format": "image/jpeg"
  }
}