seb/dashback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

unify parse api

Browse Source
This commit is contained in:
seb
2026-09-18 04:35:42 +02:00
parent adb529d14f
commit bbd285109d
5 changed files with 491 additions and 443 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/api/openapi.json
View File

@@ -4258,23 +4258,23 @@
}
}
},
"/delivery/parsePDF": {
"/delivery/parse": {
"post": {
"tags": [
"Delivery"
],
"summary": "Parse PDF (SSE)",
"description": "Accepts a PDF invoice or delivery note (`multipart/form-data`, field `pdf`)\nand streams extraction results as Server-Sent Events until parsing is complete.\n\nThe PDF is read via `pdftotext -layout` and fed page-by-page to an LLM\n(OpenRouter) which fills a structured manifest of header data and line items.\nThe OpenRouter API key is read from the authenticated user's company setting\n`keys.openrouter`; the endpoint returns `400` if the key is not configured.\n\nThe stream ends after the final `result` event (or an `error` event on failure).\n",
"summary": "Parse document (SSE)",
"description": "Accepts an invoice or delivery note as PDF or text file\n(`multipart/form-data`, field `file`) and streams extraction results as\nServer-Sent Events until parsing is complete.\n\nPDFs are read via `pdftotext -layout`; text files are decoded as UTF-8.\nPages are separated by the form feed character (`\\f`). If no form feed\nis present, the input is treated as a single page.\n\nThe extracted pages are fed to an LLM (OpenRouter) which fills a structured\nmanifest of header data and line items. The OpenRouter API key is read from\nthe authenticated user's company setting `keys.openrouter`; the endpoint\nreturns `400` if the key is not configured.\n\nThe stream ends after the final `result` event (or an `error` event on failure).\n",
"security": [
{
"cookieAuth": []
}
],
"x-markdown": "delivery/parsePDF.md",
"x-markdown": "delivery/parse.md",
"x-sse-events": [
{
"name": "status",
"description": "PDF parse confirmation and LLM status messages",
"description": "Document parse confirmation and LLM status messages",
"payload": "{ \"message\": \"…\" }"
},
{
@@ -4304,7 +4304,7 @@
},
{
"name": "error",
"description": "Emitted on PDF parse or LLM failure; stream closes immediately after",
"description": "Emitted on document parse or LLM failure; stream closes immediately after",
"payload": "{ \"message\": \"…\" }"
}
],
@@ -4315,13 +4315,13 @@
"schema": {
"type": "object",
"required": [
"pdf"
"file"
],
"properties": {
"pdf": {
"file": {
"type": "string",
"format": "binary",
"description": "PDF file to parse (max 50 MB, application/pdf)"
"description": "Document to parse (max 50 MB, application/pdf or text file)"
}
}
}
@@ -4340,7 +4340,7 @@
}
},
"400": {
"description": "No PDF uploaded or OpenRouter key not configured",
"description": "No file uploaded, unsupported file type, or OpenRouter key not configured",
"content": {
"application/json": {
"schema": {