Image Operations
Detect documents in an image
Creates a task to detect document boundaries within an image.
x-api-key
<token>
API Key for authentication
In: header
inputrequired
string
The id of the file or task to operate on.
scan_mode
string
Mode for detecting documents in the image. Available modes are:
- standard: Using a quick algorithm. Document is detected in the image, and the image is cropped to the detected document area fixing the perspective to match the document's shape.
- advanced: Using a more advanced algorithm. It can detect multiple documents in the image and crop them accordingly. This mode is more accurate but may take longer to process.
Default
"standard"Value in
"standard" | "advanced"callback_url
string
The URL to call when the task is completed or failed. If you want to receive events, you probably prefer to use webhooks instead.
Format
uriResponse Body
curl -X POST "https://api.scan-documents.com/v1/image-operations/detect-documents" \
-H "Content-Type: application/json" \
-d '{
"input": "file_avyrvozb9302uwhq"
}'const body = JSON.stringify({
"input": "file_avyrvozb9302uwhq"
})
fetch("https://api.scan-documents.com/v1/image-operations/detect-documents", {
body
})package main
import (
"fmt"
"net/http"
"io/ioutil"
"strings"
)
func main() {
url := "https://api.scan-documents.com/v1/image-operations/detect-documents"
body := strings.NewReader(`{
"input": "file_avyrvozb9302uwhq"
}`)
req, _ := http.NewRequest("POST", url, body)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import requests
url = "https://api.scan-documents.com/v1/image-operations/detect-documents"
body = {
"input": "file_avyrvozb9302uwhq"
}
response = requests.request("POST", url, json = body, headers = {
"Content-Type": "application/json"
})
print(response.text)import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import java.net.http.HttpRequest.BodyPublishers;
var body = BodyPublishers.ofString("""{
"input": "file_avyrvozb9302uwhq"
}""");
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
.uri(URI.create("https://api.scan-documents.com/v1/image-operations/detect-documents"))
.header("Content-Type", "application/json")
.POST(body)
.build();
try {
HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
System.out.println("Status code: " + response.statusCode());
System.out.println("Response body: " + response.body());
} catch (Exception e) {
e.printStackTrace();
}using System;
using System.Net.Http;
using System.Text;
var body = new StringContent("""
{
"input": "file_avyrvozb9302uwhq"
}
""", Encoding.UTF8, "application/json");
var client = new HttpClient();
var response = await client.PostAsync("https://api.scan-documents.com/v1/image-operations/detect-documents", body);
var responseBody = await response.Content.ReadAsStringAsync();{
"id": "task_euyrvozb9302uwhq",
"operation": "convert",
"parameters": {
"input": "file_avyrvozb9302uwhq",
"name": "Example Image",
"callback_url": "https://example.com/callback",
"target_format": "image/png"
},
"status": "completed",
"result": {
"documents": [
{
"file_id": "file_avyrvozb9302uwhq",
"vertices": [
{
"x": 0,
"y": 0
}
],
"bounding_box": {
"top": 0,
"left": 0,
"width": 0,
"height": 0
}
}
]
},
"callback_url": "https://example.com/callback",
"created_at": "2021-05-01T12:00:00Z",
"updated_at": "2021-05-01T12:00:00Z"
}{
"type": "https://scan-documents.com/docs/errors/not-found",
"title": "Not Found",
"status": 404,
"message": "{resource} with id {id} not found."
}{
"type": "https://scan-documents.com/docs/errors/validation-error",
"title": "Validation Error",
"status": 422,
"errors": {
"{field}": [
"{error}."
]
}
}{
"type": "https://scan-documents.com/docs/errors/rate-limit-error",
"title": "Rate Limit Exceeded",
"status": 429,
"message": "Rate limit exceeded. Please try again later or contact support."
}{
"type": "https://scan-documents.com/docs/errors/internal-error",
"title": "An unexpected error occurred. Contact support if the problem persists.",
"status": 500,
"message": "An unexpected error occurred. Contact support if the problem persists."
}