Entwickler-API

Handschrift-OCR API-Dokumentation

Integrieren Sie die fortschrittliche Handschrifterkennung von Pen to Print mit einer einfachen, REST-basierten Handschrift-zu-Text-API in Ihre Anwendungen.

API-Zugangsdaten erhalten

Die API von Pen to Print bietet eine einfache Möglichkeit, Ihrem Produkt Handschrift-zu-Text-Funktionen hinzuzufügen. Ihre Anwendung sendet eine gescannte handschriftliche Seite als base64-kodiertes Bild, und unsere fortschrittliche Handschrift-OCR-Engine wandelt den Inhalt von Bild in Text um und gibt sauberen, bearbeitbaren Text in einer strukturierten JSON-Antwort zurück.

Die Authentifizierung erfolgt mit einer userId und einem API-Secret, was die Integration in Web-, Mobil-, Desktop- oder Backend-Dienste unkompliziert macht. Die API ist zustandslos und schlank — ideal, um Handschrift-zu-Text-Funktionen wie das Digitalisieren von Notizen, das Verarbeiten gescannter Dokumente oder das Einbetten von Handschrift-OCR direkt in Ihre bestehenden Workflows zu ermöglichen.

  • REST-API
  • JSON
  • Bild zu Text

Endpoint

POST
https://api.pen-to-print.com/V1/notes
Content-Type application/json

Zugangsdaten

Beide Werte finden Sie in Ihren Kontoeinstellungen.

Feld
Wo Sie es finden
Hinweise
userId
In Ihren Kontoeinstellungen angezeigt
Erforderlich
secret
In Ihren Kontoeinstellungen angezeigt
Erforderlich; privat halten

Anfrageparameter

Senden Sie einen JSON-Body mit den folgenden Feldern:

Parameter
Typ
Erforderlich
Beschreibung
userId
string
Ja
Ihre Pen-to-Print-Benutzerkennung.
secret
string
Ja
Ihr API-Secret (aus Ihren Kontoeinstellungen).
srcImage
string
Ja
Base64-Darstellung des Quellbilds.

Beispiel-JSON-Body

{
  "userId": "YOUR_USER_ID",
  "secret": "YOUR_API_SECRET",
  "srcImage": "BASE64_IMAGE_STRING"
}

Antwort

Bei Erfolg (HTTP 200) ist die Antwort JSON:

{
  "status": 1,
  "value": "…recognized text…"
}

Fehlerantworten

Status
Wann es auftritt
Body
400
Erforderliche Parameter fehlen
{'error':'Missing parameters'}
403
Ungültiges Secret
{'error':'Unauthorized'}
405
Kein aktives Abonnement
{'error':'API access not allowed'}
500
Interner Serverfehler
{'error':'Scan failed'}

Codebeispiele

JavaScript (Node.js 18+)

import fs from "node:fs";

const endpoint = "https://api.pen-to-print.com/V1/notes";
const userId = "YOUR_USER_ID";
const secret = "YOUR_API_SECRET";

// Read an image file and convert to base64
const imageBase64 = fs.readFileSync("./image.jpg").toString("base64");

const res = await fetch(endpoint, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    userId,
    secret,
    srcImage: imageBase64,
  }),
});

const data = await res.json().catch(() => ({}));
if (!res.ok) {
  throw new Error(`Request failed: ${res.status}`);
}

console.log("Recognized text:", data.value);

Python (requests)

import base64
import requests

endpoint = "https://api.pen-to-print.com/V1/notes"
user_id = "YOUR_USER_ID"
secret = "YOUR_API_SECRET"

with open("image.jpg", "rb") as f:
    src_image = base64.b64encode(f.read()).decode("utf-8")

resp = requests.post(
    endpoint,
    json={
        "userId": user_id,
        "secret": secret,
        "srcImage": src_image,
    },
    timeout=120,
)

resp.raise_for_status()
data = resp.json()
print(data.get("value", ""))

cURL (macOS / Linux)

# 1. Export credentials
export P2P_USER_ID="YOUR_USER_ID"
export P2P_API_SECRET="YOUR_API_SECRET"

# 2. Convert image to base64
export IMG_B64="$(base64 < image.jpg | tr -d '\n')"

# 3. Call the endpoint
curl -sS -X POST "https://api.pen-to-print.com/V1/notes" \
  -H "Content-Type: application/json" \
  -d "{\"userId\":\"$P2P_USER_ID\",\"secret\":\"$P2P_API_SECRET\",\"srcImage\":\"$IMG_B64\"}" \
  | cat