{ "item": [ { "name": "v1", "description": "", "item": [ { "name": "jobs", "description": "", "item": [ { "name": "init", "description": "", "item": [ { "id": "c157c761-6340-47f8-ac0d-35047e635c9b", "name": "Create a job and get an upload URL", "request": { "name": "Create a job and get an upload URL", "description": { "content": "Validates the file metadata and returns a short-lived signed URL to PUT the blueprint bytes to. Optional `Idempotency-Key` header.", "type": "text/plain" }, "url": { "path": [ "v1", "jobs", "init" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"vendor\": \"zod\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f48ae122-5211-49c8-a06c-e7295e30bf6f", "name": "Job created; upload the file next.", "originalRequest": { "url": { "path": [ "v1", "jobs", "init" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"vendor\": \"zod\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"job_id\": \"\",\n \"status\": \"\",\n \"external_ref\": \"\",\n \"upload\": {\n \"method\": \"\",\n \"url\": \"\",\n \"content_type\": \"\",\n \"max_bytes\": \"\",\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23e18725-82fe-455f-88db-55709dc421c4", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "v1", "jobs", "init" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"vendor\": \"zod\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4a4dd1a-3172-43f5-816c-52fa5314fc67", "name": "Unsupported mime_type / size / callback_url", "originalRequest": { "url": { "path": [ "v1", "jobs", "init" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"vendor\": \"zod\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8def783-6c2f-45e6-95ac-ed21d2166c36", "name": "Rate limit exceeded", "originalRequest": { "url": { "path": [ "v1", "jobs", "init" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"vendor\": \"zod\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "{id}", "description": "", "item": [ { "name": "start", "description": "", "item": [ { "id": "7cee08c0-870b-4558-9abe-ff875f3fbd98", "name": "Start processing an uploaded job", "request": { "name": "Start processing an uploaded job", "description": { "content": "Verifies the uploaded file and queues it for AI inference. Returns immediately; status moves queued → processing → done.", "type": "text/plain" }, "url": { "path": [ "v1", "jobs", ":id", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7f92eed7-d9eb-4134-976e-785a6c7354c4", "name": "Queued for processing.", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": {} }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"job_id\": \"\",\n \"status\": \"\",\n \"poll_url\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a60f95df-0c47-4fd1-877c-799f1547815a", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9954f5e8-bcbe-47ae-bdec-0f92b21355e6", "name": "Already started/processed.", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01f48a04-5ea5-4c52-bcf8-72d04c876074", "name": "No/invalid upload found.", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4acab87-263f-4e30-85f5-4d048ff43e29", "name": "Rate limit exceeded", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "id": "5fd38ea2-3497-4c8b-86a5-aa13b0d5b8ce", "name": "Poll job status / get results", "request": { "name": "Poll job status / get results", "description": { "content": "While running, returns status only. When `done`, returns the take-off summary + per-page metadata. Query: `?confidence=` (flat override), `?include=detections` (inline detections for small jobs).", "type": "text/plain" }, "url": { "path": [ "v1", "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ae26e3e7-bde7-448d-a709-ed9404608a67", "name": "Job status. Running states (`queued`/`processing`) return status only; `done` returns the take-off summary + pages; `failed` returns an error.", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"job_id\": \"\",\n \"status\": \"\",\n \"external_ref\": \"\",\n \"completed_at\": \"\",\n \"file_name\": \"\",\n \"page_count\": \"\",\n \"pages_with_detections\": \"\",\n \"confidence_mode\": \"\",\n \"inference_thresholds\": {\n \"eiusmod_c1\": {\n \"confidence\": \"\",\n \"single_class\": \"\"\n }\n },\n \"summary\": {\n \"total_detections\": \"\",\n \"by_symbol\": [\n {\n \"class\": \"\",\n \"display_name\": \"\",\n \"talo2010_code\": \"\",\n \"category\": \"\",\n \"count\": \"\"\n },\n {\n \"class\": \"\",\n \"display_name\": \"\",\n \"talo2010_code\": \"\",\n \"category\": \"\",\n \"count\": \"\"\n }\n ],\n \"by_category\": {\n \"magna98b\": \"\"\n }\n },\n \"pages\": [\n {\n \"page_index\": \"\",\n \"width_px\": \"\",\n \"height_px\": \"\",\n \"render_dpi\": \"\",\n \"detection_count\": \"\",\n \"detections_url\": \"\",\n \"image_url\": \"\",\n \"detections\": [\n {\n \"id\": \"\",\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\",\n \"confidence\": \"\",\n \"bbox_norm\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"bbox_px\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"source\": {\n \"yolo\": \"\",\n \"vector_matching\": \"\"\n },\n \"gemini\": {\n \"decision\": \"\",\n \"confidence\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\",\n \"confidence\": \"\",\n \"bbox_norm\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"bbox_px\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"source\": {\n \"yolo\": \"\",\n \"vector_matching\": \"\"\n },\n \"gemini\": {\n \"decision\": \"\",\n \"confidence\": \"\"\n }\n }\n ]\n },\n {\n \"page_index\": \"\",\n \"width_px\": \"\",\n \"height_px\": \"\",\n \"render_dpi\": \"\",\n \"detection_count\": \"\",\n \"detections_url\": \"\",\n \"image_url\": \"\",\n \"detections\": [\n {\n \"id\": \"\",\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\",\n \"confidence\": \"\",\n \"bbox_norm\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"bbox_px\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"source\": {\n \"yolo\": \"\",\n \"vector_matching\": \"\"\n },\n \"gemini\": {\n \"decision\": \"\",\n \"confidence\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\",\n \"confidence\": \"\",\n \"bbox_norm\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"bbox_px\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"source\": {\n \"yolo\": \"\",\n \"vector_matching\": \"\"\n },\n \"gemini\": {\n \"decision\": \"\",\n \"confidence\": \"\"\n }\n }\n ]\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99139114-3dca-4f7f-ac4c-d476462a7d2a", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9a3755b-607a-4829-92de-e1572d26095f", "name": "Job not found (or not yours).", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cb8b98d4-392d-45b1-9ad1-fe139033213a", "name": "Rate limit exceeded", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "pages", "description": "", "item": [ { "name": "{page}", "description": "", "item": [ { "name": "detections", "description": "", "item": [ { "id": "4ad14bd3-1d8e-4de1-9699-3316fc9024e5", "name": "Per-page detections (paginated)", "request": { "name": "Per-page detections (paginated)", "description": { "content": "Detections for one page (0-based). Query: `?limit=&offset=&confidence=`. Same confidence filter as the summary, so counts reconcile.", "type": "text/plain" }, "url": { "path": [ "v1", "jobs", ":id", "pages", ":page", "detections" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "page", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0c2ca0f8-be77-4c74-b8be-041dedf0baad", "name": "Paginated detections for the page.", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "pages", ":page", "detections" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"page_index\": \"\",\n \"width_px\": \"\",\n \"height_px\": \"\",\n \"render_dpi\": \"\",\n \"confidence_mode\": \"\",\n \"total\": \"\",\n \"limit\": \"\",\n \"offset\": \"\",\n \"next\": \"\",\n \"detections\": [\n {\n \"id\": \"\",\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\",\n \"confidence\": \"\",\n \"bbox_norm\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"bbox_px\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"source\": {\n \"yolo\": \"\",\n \"vector_matching\": \"\"\n },\n \"gemini\": {\n \"decision\": \"\",\n \"confidence\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\",\n \"confidence\": \"\",\n \"bbox_norm\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"bbox_px\": {\n \"x\": \"\",\n \"y\": \"\",\n \"width\": \"\",\n \"height\": \"\"\n },\n \"source\": {\n \"yolo\": \"\",\n \"vector_matching\": \"\"\n },\n \"gemini\": {\n \"decision\": \"\",\n \"confidence\": \"\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75aa0f2d-18c6-4fa6-afc0-f754391fd56e", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "pages", ":page", "detections" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22a68087-7746-4c44-8048-97dc3fa313b9", "name": "Job/page not found.", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "pages", ":page", "detections" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b9490f0-1954-409f-8fb7-8963aff27bfe", "name": "Rate limit exceeded", "originalRequest": { "url": { "path": [ "v1", "jobs", ":id", "pages", ":page", "detections" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ] } ] }, { "name": "symbols", "description": "", "item": [ { "id": "31ec48a0-b0d9-4898-8307-053ce5ce62ef", "name": "Symbol catalog", "request": { "name": "Symbol catalog", "description": { "content": "The full dictionary of detectable symbols (class → display_name → Talo 2010 code → icon). Fetch once and cache; map each `class`/`talo2010_code` to a product in your registry.", "type": "text/plain" }, "url": { "path": [ "v1", "symbols" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7bd2298f-4b99-46fe-9f9e-ddf4ce5746d4", "name": "Catalog of current symbols.", "originalRequest": { "url": { "path": [ "v1", "symbols" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"models\": [\n \"\",\n \"\"\n ],\n \"count\": \"\",\n \"symbols\": [\n {\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\"\n },\n {\n \"class\": \"\",\n \"display_name\": \"\",\n \"category\": \"\",\n \"symbol_category\": \"\",\n \"color\": \"\",\n \"talo2010_code\": \"\",\n \"icon_url\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd9af782-7114-428f-b957-ea93aaad94cc", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "v1", "symbols" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{class}", "description": "", "item": [ { "name": "icon", "description": "", "item": [ { "id": "9e402296-86cf-457a-b2f7-f0f4717a7bb8", "name": "Symbol icon (image)", "request": { "name": "Symbol icon (image)", "description": { "content": "Redirects (302) to an image of the symbol glyph. Safe to use as an src.", "type": "text/plain" }, "url": { "path": [ "v1", "symbols", ":class", "icon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "class", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2dcfa0bf-9756-47e5-a11d-035616a0b522", "name": "Redirect to a signed icon image URL.", "originalRequest": { "url": { "path": [ "v1", "symbols", ":class", "icon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Found", "code": 302, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d050df80-5ea0-4b75-a3de-22f7b785ce1a", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "v1", "symbols", ":class", "icon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7714ec59-1676-4bf7-9af0-0559addf25f0", "name": "No icon for this symbol.", "originalRequest": { "url": { "path": [ "v1", "symbols", ":class", "icon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ] } ], "auth": { "type": "apikey", "apikey": [ { "type": "any", "value": "X-API-Key", "key": "key" }, { "type": "any", "value": "{{apiKey}}", "key": "value" }, { "type": "any", "value": "header", "key": "in" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.massalaskuri.com" } ], "info": { "_postman_id": "c6898eae-6bf7-406d-97b2-f3150b35643b", "name": "Massalaskuri Partner API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Upload a construction blueprint PDF → Massalaskuri AI detects electrical & fire-alarm symbols →\nyou get back every symbol with **normalized coordinates** plus a **quantity take-off** (counts by symbol & Talo 2010 code).\n\n👉 **See it live:** [interactive blueprint demo](/playground) · **5-min integration kit:** [/examples](/examples) (sample PDF + bash/Node/Python + webhook receiver) · **Status:** [/status](/status)\n\n## Quickstart\n1. `POST /v1/jobs/init` with `{ file_name, mime_type, size }` → returns `{ job_id, upload.url }`.\n2. `PUT` the file bytes to `upload.url` (Content-Type = your mime_type; no API key on this PUT).\n3. `POST /v1/jobs/{id}/start` → returns `202 queued`.\n4. Poll `GET /v1/jobs/{id}` until `status:\"done\"` — or set `callback_url` to receive a webhook.\n5. Read detections: `GET /v1/jobs/{id}/pages/{n}/detections`.\n\n## Authentication\nSend your key in the `X-API-Key` header on every request. Use the **Authentication** button\nabove to set it, then try any endpoint live.\n\n## Coordinates\nUse `bbox_norm` (0–1 fractions, top-left origin) to place boxes on any rendering of the page —\nit is DPI-independent. `bbox_px` (200-DPI raster) is provided for reference.\n\n## Webhooks\nIf you pass `callback_url`, we POST the completed job (signed `X-Massalaskuri-Signature: t=,v1=`,\nwhere `v1 = HMAC_SHA256(your_webhook_secret, \".\" + rawBody)`). Verify it before trusting the payload.\n\nContact Support:\n Name: Massalaskuri", "type": "text/plain" } } }