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 erhaltenDie 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
Zugangsdaten
Beide Werte finden Sie in Ihren Kontoeinstellungen.
userIdsecretAnfrageparameter
Senden Sie einen JSON-Body mit den folgenden Feldern:
userIdsecretsrcImageBeispiel-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
{'error':'Missing parameters'}{'error':'Unauthorized'}{'error':'API access not allowed'}{'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