Je werkruimte laden…
Je werkruimte laden…
Dezelfde functies als in je werkruimte, met expliciete rechten en accountgrenzen.
Log in in de werkruimte en maak een token onder ‘API & tokens’. Bewaar het geheim in je eigen systeem. Stuur het als Bearer-header. Je kunt het direct intrekken; de geldigheid kies je zelf, maximaal 365 dagen.
Authorization: Bearer <YOUR_TOKEN> Content-Type: application/json
Lees- en schrijfrechten zijn afzonderlijk voor prints, links, websites en generatie. Tokens kunnen geen andere tokens maken. Publicatie van Smart Links gebeurt via je browsersessie na een preview. Een token voor één Smart Link kan alleen dat concept bewerken.
curl https://omnitechs.nl/api/v1/calculator \ -F "[email protected]" curl https://omnitechs.nl/api/v1/calculator/<FILE_ID> \ -H "x-estimate-token: <FILE_TOKEN>" \ -H "Content-Type: application/json" \ -d '{"unit":"mm","scalePercent":100,"materialId":"pla","colourId":"unsure","qualityId":"standard","useId":"functional","quantity":1,"customerTypeId":"private"}'
Boven 32 MB gebruikt de browser losse delen: POST /api/print-estimates/uploads met JSON {fileName,sizeBytes}; bewaar id en token. Stuur opeenvolgende delen van 8 MiB naar PUT /api/print-estimates/uploads/{id}/{index} (vanaf 0) met x-print-upload-token. POST naar /complete geeft het normale bestand-ID/token voor de calculator. Deze routes vereisen dezelfde Origin als de website. DELETE op de sessie annuleert onafgeronde delen. De multipart-route hierboven blijft begrensd op 40 MiB. Herhaal een verloren complete-antwoord niet automatisch; alleen expliciet busy kan opnieuw.
STL/3MF: maximaal 256 MB. Een indicatie is geen geaccepteerde offerte of printopdracht. Ingestuurde calculatorbestanden: maximaal 90 dagen; overige uploads: 7 dagen. Bij offerteacceptatie bewaren we een afzonderlijke privékopie voor productie en ondersteuning. Hiervoor is nog geen automatische verwijdertermijn; zie het privacybeleid. Adressen zijn momenteel beperkt tot Nederland.
Optioneel commercial bij POST /prints: qualityService (customer_prepared of full_review), removeSupports, brandId of null, gift (recipient en message) of null, en fulfilment ({timing:now} of {timing:scheduled,requestedDate:YYYY-MM-DD}). Quantity en printkwaliteit komen uit de vastgelegde calculator-keuzes. De werkplaats bevestigt bestand, capaciteit en leverdatum vóór een betaalbare offerte. Ook customer_prepared behoudt verplichte machine- en veiligheidscontroles.
{
"qualityService": "full_review",
"removeSupports": true,
"brandId": null,
"gift": {
"recipient": "Alex",
"message": "Happy birthday"
},
"fulfilment": {
"timing": "now"
}
}Services in centen inclusief 21% btw, vóór planningfactor: {"fullReviewInclVatCents":4900,"supportRemovalPerUnitInclVatCents":450,"brandingInclVatCents":1200,"giftPerUnitInclVatCents":950}. De server berekent en bevriest alle regels in quote.commercial. Bedragen, factoren of een client-quantity in commercial worden geweigerd. Verzending blijft apart.
Verzenden onder jouw merk vereist vooraf registreren: upload een eigen PNG/JPEG via POST /images, daarna POST /prints/brands met name, logoId en packingNote. GET /prints/brands geeft je actieve merken. Gebruik hun id als brandId. DELETE /prints/brands/{id} archiveert voor nieuwe aanvragen; bestaande aanvragen bewaren hun merk. Maximaal 20 actieve merken; geen wijziging van factuuridentiteit.
Gebruik generation:write om een basisgeneratie te starten. Je saldo wordt gereserveerd; een mislukte provider-taak wordt terugbetaald. Geef één idempotency-key per poging en hergebruik die bij een netwerkfout. Verander de inhoud niet onder dezelfde sleutel. Maximaal drie actieve taken per account.
curl https://omnitechs.nl/api/v1/generation \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "idempotency-key: <OPAQUE_ATTEMPT_ID>" \
-H "Content-Type: application/json" \
-d '{"kind":"text","prompt":"A simple low-poly planter","imageIds":[]}'Controleer /capabilities voor beschikbaarheid. Resultaten worden lokaal bewaard voordat de taak ‘SUCCEEDED’ wordt. Download ze met generation:read. Voor beeldgeneratie zijn eigen JPEG/PNG-upload-ID's nodig; externe afbeelding-URL's worden geweigerd.
GET /billing/balance met generation:read geeft je eigen saldo en de conversie van digitale credits naar euro's. Tokens voor één Smart Link hebben geen toegang tot het accountsaldo.
Basisgeneratie wordt uit je vooraf betaalde saldo gereserveerd. In ‘Account en betalingen’ kun je automatisch aanvullen instellen met een bedrag, saldodrempel en UTC-maandlimiet. Stripe bewaart de betaalmethode. Toestemming en stoppen zijn browseracties; je API-token kan deze machtiging niet veranderen. Een openstaande aanvulling krijgt geen tweede afschrijving. Bij bankbevestiging verschijnt dezelfde betaalfactuur in je account.
Na beoordeling van een printofferte kun je POST /prints/{id}/pay gebruiken met prints:write en expliciet verleende prints:pay, revision, quoteId, accepted:true en locale. Dit betaalt uit hetzelfde saldo zonder Checkout voor elke opdracht. Bij onvoldoende saldo kan je gekozen automatische aanvulling plaatsvinden. Een 402 betekent dat de opdracht niet betaald is: controleer je saldo, maandlimiet of betaalbevestiging en herhaal veilig dezelfde offerte. Een gestart Checkout-traject kan niet tegelijk uit saldo worden betaald.
Upgrade van betaald Pro naar Business in het paneel: vraag eerst de actuele verrekening op en geef daarna toestemming voor het exacte bedrag. Alleen het verschil voor de resterende periode wordt geïncasseerd op je opgeslagen betaalmethode; de verlengdatum blijft gelijk. Bij een mislukte betaling blijft betaald Pro geldig en herstel je dezelfde Stripe-factuur. POST /links/subscription met action quote_upgrade of upgrade is uitsluitend voor een browsersessie; upgrade vereist quoteId, consent:true en de actuele consentVersion uit het contract. Tokens mogen geen abonnement kopen of wijzigen.
Business bevat één actief eigen domein. Via GET /links/domain krijg je de DNS-instructies; POST met action connect, verify of remove is alleen voor je ingelogde browsersessie. API-tokens kunnen geen domein claimen. Je account moet eigendom bewijzen met de _omnitechs TXT-record. Alleen een gepubliceerde pagina met geldig betaald Business-plan, actieve HTTPS en actuele DNS-eigendomscontrole wordt op het domein weergegeven. Domein loskoppelen annuleert je abonnement niet.
Pro: €15 per maand inclusief btw, 100 nieuwe MCP-sessies. Business: €25 per maand inclusief btw, 1000 sessies en een eigen domein zodra domeinverificatie beschikbaar is. Abonneren en verlenging annuleren doe je in het paneel. De betaalde periode blijft geldig; quota worden per UTC-kalendermaand geteld, niet per factuur.
Gratis: 5 nieuwe MCP-sessies per UTC-kalendermaand, over al je links en tokens. Lees je gebruik in het paneel. Verder werken in dezelfde sessie telt niet opnieuw, ook niet na een maandgrens.
Bewaar de Mcp-Session-Id uit initialize en stuur hem met iedere volgende aanvraag; je Bearer-token blijft verplicht. Bewaar ook een eigen Idempotency-Key bij initialize. Zonder die sleutel herstellen identieke initialisaties binnen 120 seconden dezelfde sessie. DELETE /mcp sluit de sessie; verbruik wordt niet teruggegeven. Bij 402 kun je bestaande sessies blijven gebruiken. Bij 404 initialiseer je opnieuw.
Maak pagina's met secties en een thema. Dezelfde JSON werkt in de editor, REST API en MCP. V1-pagina's met alleen actions blijven geldig. Maximaal 40 secties, 20 items per sectie en 48 KiB pagina-JSON; transportverzoeken maximaal 64 KiB.
// Node.js: create an account-owned draft. Supply your own secret from the environment.
const base = 'https://omnitechs.nl/api/v1';
const headers = {
Authorization: 'Bearer ' + process.env.OMNITECHS_TOKEN,
'Content-Type': 'application/json',
};
const page = {
"title": "My page",
"intro": "",
"accent": "forest",
"actions": [],
"version": 2,
"theme": {
"background": "#f7f5ef",
"foreground": "#202a25",
"accent": "#245d46",
"font": "sans",
"width": "comfortable",
"radius": "soft",
"buttonStyle": "solid",
"spacing": "comfortable"
},
"sections": [
{
"id": "about",
"type": "text",
"title": "About",
"text": "Your own content",
"image": "",
"imageAlt": "",
"url": "",
"items": [],
"align": "left",
"columns": 2,
"surface": "plain",
"hidden": false,
"html": "",
"css": "",
"javascript": "",
"height": 320
}
]
};
const response = await fetch(base + '/links', {
method: 'POST', headers, body: JSON.stringify(page),
});
if (!response.ok) throw new Error('Create failed: ' + response.status);
const { record } = await response.json();
// Send the current revision. On 409, reread and reconcile before retrying.
const saved = await fetch(base + '/links/' + record.id, {
method: 'PATCH', headers,
body: JSON.stringify({ revision: record.revision, data: page }),
});
if (!saved.ok) throw new Error('Save failed: ' + saved.status);Widgets met eigen HTML/CSS/JavaScript zijn geïsoleerd: geen toegang tot accountcookies of de bovenliggende pagina, geen fetch, formulieren of geneste frames. Publiceer alleen content die je hebt bekeken. Externe HTTPS-afbeeldingen laden in de browser; embeds ondersteunen YouTube, Vimeo en Calendly.
Maak een Smart Link in de werkruimte en daar een token voor die ene link. Verbind je AI met /api/v1/mcp via Streamable HTTP en een Bearer-header. Tools: get_smart_link en update_smart_link. Gebruik de actuele revision bij een wijziging. Een conflict geeft geen overschrijving; laad het concept opnieuw.
MCP ondersteunt protocol 2025-11-25, 2025-06-18 en 2025-03-26. De client moet application/json én text/event-stream accepteren. Er is geen OAuth-aanmeldflow; kies een client die aangepaste Bearer-headers ondersteunt.
/websites bewaart je projectdoel en platformkeuze: wordpress, nextjs of advise. Eén gratis site per account, gehost door OmniTechs. Een concept gebruikt nog geen websiteplek. Controleer GET /capabilities: alleen bij websiteProvisioning:true kun je POST /websites/{id}/provision sturen met de actuele revision en websites:write. Een 202-antwoord betekent dat het project is aangenomen; lees GET /websites/{id} tot ready, failed of capacity_blocked. Alleen ready bevat een geverifieerde publieke URL. Een retry gebruikt dezelfde websiteplek.
Met advise kiest een gewone website de statische Next.js-starter en een webshop WordPress. De Next.js-starter heeft geen webshop; die combinatie geeft 422. Bij 409 ververs je de revision of open je het project dat je gratis plek al gebruikt. Bij 503 blijft je concept bewaard: hosting is uitgeschakeld of vol.
Na ready kun je POST /websites/{id}/source gebruiken met revision en websites:read. Het antwoord is een privaat tar.gz-bronarchief van maximaal 1 MiB; x-content-sha256 bevat de SHA-256. Herstelarchieven en wachtwoorden zijn uitgesloten. WordPress-inloggegevens vraag je via de browsersessie op met POST /websites/{id}/credentials, revision en je huidige OmniTechs-password. API-tokens zijn hiervoor verboden en er geldt een limiet van vijf pogingen per minuut. Dit zijn de oorspronkelijke WordPress-inloggegevens; een later gewijzigd WordPress-wachtwoord wordt niet teruggezet.
Bij Next.js bevat het bronarchief je statische websitecode. Bij WordPress bevat het de hostingconfiguratie; exporteer je pagina-inhoud via WordPress → Gereedschap → Exporteren. Private database- en herstelback-ups worden niet als bronarchief verstrekt.
Dezelfde wachtrij verwerkt /websites/{id}/edit (revision, title, description; alleen de statische Next.js-pagina), /pause en /resume (revision). Gebruik websites:write en lees de projectstatus na 202. Pause stopt de site en bewaart je bestanden, database en gratis plek. Resume controleert capaciteit en publieke identiteit opnieuw. WordPress-inhoud wijzig je in de native editor.
POST /websites/{id}/restore vereist je browsersessie, revision, je huidige OmniTechs-password en confirmRestore:true. API-tokens mogen niet herstellen. Dit vervangt de site en WordPress-database door de oorspronkelijke back-up, met een herstelkopie vooraf en tijdelijke uitval. Een mislukte edit of restore blijft gestopt voor expliciet herstel. Alle muterende hostingacties geven 503 zolang websiteProvisioning:false is.
MCP: list_websites en get_website lezen je eigen projecten. create_website maakt alleen een concept; update_website_draft wijzigt dat concept. provision_website, edit_website_content, pause_website en resume_website vragen met de huidige revision een serveractie aan. Controleer daarna get_website: queued is nog niet klaar. Bij een onduidelijke conceptaanmaak lees je eerst de lijst voordat je opnieuw aanmaakt. get_website_owner_actions verwijst naar de ingelogde eigenaar voor herstel, broncode, toegang en definitief verwijderen; MCP geeft hiervoor alleen een verwijzing. Herstel, toegang en verwijderen vereisen de eigenaar; broncode blijft ook via de bestaande REST-route met websites:read beschikbaar. Eén gratis actieve site; bevestigd verwijderen maakt een vervanging mogelijk.
Dezelfde stappen zijn beschikbaar via MCP: get_website_resources, quote_website_resources, get_website_resource_purchase, pay_website_resources en cancel_website_resource_quote. Maak een token met alleen de benodigde website-rechten. Betalen vereist zowel websites:write als websites:pay; een bewerktoken krijgt geen betaalrecht. Binnen dezelfde MCP-sessie kosten vervolgacties geen extra verbinding.
De gratis actieve site bevat 200 MB werkelijke opslag. Extra opslag, RAM en gedeelde CPU worden afzonderlijk voor één jaar vooruitbetaald; de maandprijs is alleen een vergelijking. Prijzen zijn inclusief 21% btw. CPU is een gedeeld limiet, geen dedicated processor of snelheidsgarantie.
{
"acceptedTotalInclVatCents": 18000,
"consent": true,
"consentVersion": "annual-resources-2026-10-10"
}Voor verlenging: POST /websites/{id}/resources/renewal met revision en een nieuwe idempotencyKey, of MCP quote_website_resource_renewal. De server selecteert alleen eigen perioden die zijn verlopen of binnen 30 dagen eindigen. Je betaalt de geretourneerde aankoop met hetzelfde pay-endpoint en exacte toestemming. Een vroege verlenging behoudt je betaalde einddatum; verlopen perioden starten een nieuw jaar bij de voorbereiding van activering. De fysieke opslag, RAM en CPU blijven gelijk. terminalPeriods in GET toont de bevestigde laatste periode per resource; toekomstige betaalde perioden worden niet opnieuw verkocht.
Een uit saldo betaalde upgrade zonder enige serverpoging kun je met POST /websites/{id}/resources/{purchaseId}/refund en confirmBalanceRefund:true één keer terug naar hetzelfde saldo laten zetten. MCP: refund_unstarted_website_upgrade. Dit vereist websites:write en websites:pay en is geen kaartrefund. Zodra werk begonnen is, een jaar actief is of de betaalstatus onzeker is, wordt dit geweigerd; behoud het aankoopnummer voor support.
Prijzen worden één uur vastgehouden; capaciteit wordt vóór betalen opnieuw gecontroleerd. Een geslaagde saldo-aanvulling blijft beschikbaar als de host daarna geen capaciteit heeft. Alleen een onbetaalde reservering zonder open Checkout kan met DELETE worden vrijgegeven. De vastgelegde UTC-jaarperiode staat in de actieve aankoop; verlenging is handmatig. Na afloop stopt de site, met behoud van bestanden en toegewezen ruimte voor herstel. Hervatten maakt geen nieuw betaald jaar.
GET /api/v1/generation/studioRead owned projects and versions; generation:read; offset pages of 50POST /api/v1/generation/studioQuote, start, refresh, save draft or update owned project; generation:write. Start requires a UUID attemptId, approvedCredits and priceVersion from quote. Same attempt must be reused on retry. Input follows StudioInput with operation-specific validation.GET /api/v1/generation/studio/projectRead brief, bounded conversation, revision and assistantPending for an owned active project; projectId UUID query; generation:read.POST /api/v1/generation/studio/projectSave a brief with projectId and expected revision; generation:write. Stale revisions or pending assistant requests return409. No provider execution.POST /api/v1/generation/studio/assistantPropose a validated studio edit from message, input, locale and current project revision; generation:write. Server-held conversation only; caller history refused. Durable pending claim prevents concurrent provider calls; unresolved requests require operator recovery. No generation or wallet authority. Separate provider activation required.GET /api/v1/dropshippingRead account-owned dropshipping products, material stock, orders and offered filament; dropshipping:readPOST /api/v1/dropshippingEnrol, register incoming material, submit orders or cancel; dropshipping:write. Reuse operationId on retry; revision conflicts return409.POST /api/v1/dropshipping/paymentsBuy offered filament, resume shipping/filament checkout or cancel an unpaid purchase; dropshipping:pay. Payment only confirmed by Stripe, never by redirect.POST /api/v1/dropshipping/shippingConnect/disconnect customer DHL; browser session only, encrypted credentialsGET /api/v1/dropshipping/products/{id}/fileDownload private owned STL; photo=1 for retained image; dropshipping:readGET /api/v1/dropshipping/orders/{id}/invoiceDownload production invoice PDF; dropshipping:readGET /api/v1/dropshipping/orders/{id}/labelDownload confirmed DHL label; dropshipping:readGET /api/v1/billing/rechargeRead owned recharge settings, month cap and payment recovery (browser session only)POST /api/v1/billing/rechargePrepare explicit automatic recharge consent or disable it (browser session only); saved payment details stay in StripeGET /api/v1/billing/balanceRead owned prepaid balance using account-wide generation:read; contains no payment credentialsPOST /api/v1/prints/{id}/payAccept a reviewed print quote and pay atomically from prepaid balance with prints:write plus explicitly granted prints:pay; opted-in recharge may replenish funds. Existing editing tokens do not gain financial authorityGET /api/v1/prints/brandsList up to 20 owned active packaging brands with account-wide prints:readPOST /api/v1/prints/brandsRegister immutable packaging brand with prints:write and an owned PNG/JPEG logo ID previously uploaded through /images. No SVG, foreign image, arbitrary URL or invoice identity changeDELETE /api/v1/prints/brands/{id}Archive owned packaging brand with prints:write; existing immutable requests retain their recorded brand, new applications cannot select itGET /api/v1/printsList account-owned printsPOST /api/v1/printsCreate account-owned printsGET /api/v1/linksList account-owned linksPOST /api/v1/linksCreate account-owned linksGET /api/v1/websitesList account-owned website draftsPOST /api/v1/websitesCreate account-owned website draftsGET /api/v1/links/{id}Read account-owned Smart LinkPATCH /api/v1/links/{id}Save Smart Link with revision checkingGET /api/v1/websites/{id}Read account-owned website draftPATCH /api/v1/websites/{id}Save website draft with revision checkingGET /api/v1/websites/{id}/resourcesRead owned annual storage/RAM/shared CPU prices, activation availability and applied resource state with websites:readPOST /api/v1/websites/{id}/resourcesReserve an incremental annual quote with websites:write, current revision and a UUID idempotency key; fresh physical capacity is required before fundingGET /api/v1/websites/{id}/resources/{purchaseId}Read only this owned annual purchase with websites:read; paid is applying until exact host activation proof commits activeDELETE /api/v1/websites/{id}/resources/{purchaseId}Cancel only an owned unfunded non-Checkout reservation with websites:write; funded/ambiguous work retains recovery and capacityPOST /api/v1/websites/{id}/resources/renewalReserve a manual annual renewal quote for all owned terminal periods expired or ending within 30 days; websites:write, current revision and stable UUID required. Physical limits stay unchanged. Early renewal preserves paid time; an expired term starts at activation preparation. No payment until exact consent through the shared purchase pay endpointPOST /api/v1/websites/{id}/resources/{purchaseId}/payAccept the exact annual quote and spend prepaid balance once with websites:write plus explicitly granted websites:pay; opted-in bounded recharge can replenish funds, with fresh capacity checked again before debitPOST /api/v1/websites/{id}/resources/{purchaseId}/refundReturn an owned balance-funded annual payment to prepaid balance once, only before the first host attempt; requires websites:write and websites:pay. Active, attempted, uncertain and Checkout-funded purchases require support recoveryPOST /api/v1/websites/{id}/provisionQueue or retry your one free Mac-hosted website when provisioning is enabledPOST /api/v1/websites/{id}/sourceDownload your ready website's Git source archive using websites:read; recovery archives and credentials are excludedPOST /api/v1/websites/{id}/editQueue static Next.js title/description changes with websites:write; retain a recovery copyPOST /api/v1/websites/{id}/restoreQueue initial-backup restore with browser reauthentication and explicit consent; API tokens forbiddenPOST /api/v1/websites/{id}/pauseQueue an owned site stop using websites:write; retain files, database and allocationPOST /api/v1/websites/{id}/resumeQueue the same paused site using websites:write; capacity and public identity are verified againPOST /api/v1/websites/{id}/deleteDelete an owned hosted website, its files/database/recovery archives and release the active free allocation; browser reauthentication and explicit consent required, API tokens forbiddenPOST /api/v1/websites/{id}/credentialsReveal initial WordPress credentials with a same-origin browser session and password reauthentication; API tokens are forbiddenGET /api/v1/prints/{id}Read your saved print applicationGET /api/v1/prints/{id}/fileDownload your original print file within its retention windowGET /api/v1/prints/{id}/receiptDownload an owned paid print's payment confirmation PDF with prints:read; not a tax invoicePOST /api/v1/prints/{id}/checkoutAccept the current reviewed quote with prints:write and obtain a hosted payment URLGET /api/v1/generationList your generation jobsPOST /api/v1/generationReserve balance and start a base Meshy generationGET /api/v1/generation/{id}Poll your provider task and settle its outcomeGET /api/v1/generation/files/{id}/{format}Download your retained local modelPOST /api/v1/imagesUpload an account-owned image, up to 8 MiB, for prints, generation or dropshipping (matching write scope required)GET /api/v1/tokensBrowser session: list redacted token metadataPOST /api/v1/tokensBrowser session: issue a one-time tokenDELETE /api/v1/tokens/{id}Browser session: revoke your token immediatelyPOST /api/v1/calculatorPublic STL/3MF upload, up to 40 MiBGET /api/v1/calculator/{id}Read an estimate with its private capabilityPOST /api/v1/calculator/{id}Queue slicing with approved material, quality and quantity choicesDELETE /api/v1/mcpClose the currently owned token-bound MCP session; no quota refundPOST /api/v1/mcpSmart Link MCP Streamable HTTP; link scopes and JSON-RPC 2.0GET /api/v1/links/usageRead owned MCP new-session usage and UTC calendar-month limit; browser session onlyGET /api/v1/links/subscriptionRead owned Smart Link subscription and current prices (browser session only)POST /api/v1/links/subscriptionConsent to a monthly subscription or cancel the next renewal (browser session only)GET /api/v1/links/domainRead owned custom-domain state and DNS instructions (browser session only)POST /api/v1/links/domainConnect, verify or remove one Business custom domain (browser session only)GET /api/v1/capabilitiesRead current generation and provisioning availability without secretsGET /api/v1/openapiRead this OpenAPI contract401: log in of vervang een ongeldig token. 403: controleer rechten en browserorigin. 409: laad de versie opnieuw of controleer de eerdere generatiepoging. 429: wacht of verlaag je gebruik. 503: afhankelijkheid niet beschikbaar. Bewaar x-request-id voor ondersteuning; stuur nooit je token mee in een log of URL.
Werkruimte: 30 verzoeken per minuut per IP en 90 per account. Calculator per IP: 20 uploads en 60 berekeningen per uur, 90 statusverzoeken per minuut. Maximaal 50 records per type en 20 actieve API-tokens. Verzoeken en downloads zijn privé en worden niet openbaar gecachet.