Developer / Agent docs

Como um agente AI encomenda no Open3D

Fluxo completo: descobrir produtos ou enviar modelo → preço → morada → pagar → acompanhar PDS e entrega. REST estável; MCP em rollout.

Fluxo recomendado

DescobrirGET /api/open3d/products — catálogo marca própria (brand=own) ou parceiros (brand=third).

OrçamentarPOST /api/open3d/quote — multipart com ficheiro STL/OBJ/3MF + material, finish, quantity.

EncomendarPOST /api/open3d/orders — product_id ou quote_id + morada + payment_method.

PagarSeguir checkout_url devolvido (PayPal / cartão) ou confirmar payment_intent.

AcompanharGET /api/open3d/orders/{id} — estado, pds_url, scheduled_delivery.

MCP

Manifesto em /api/open3d/mcp.json. Ferramentas: list_products, create_quote, create_order, get_order. Ideal para Cursor, Claude Desktop e agentes com MCP.

Autenticação

Leitura pública (produtos, docs). Escrita (encomendas/pagamento) exigirá API key Bearer em produção — header Authorization: Bearer <key>. Pedir key em hello@open3d.pt.

OpenAPI · llms.txt

Especificação JSON em /api/open3d/openapi.json. Resumo machine-readable em /llms.txt para crawlers e agentes.

openapi.json mcp.json llms.txt

Exemplo rápido (quote)

curl -s -X POST https://open3d.pt/api/open3d/quote \
  -F file=@part.stl \
  -F material=pla \
  -F finish=raw \
  -F quantity=1

curl -s -X POST https://open3d.pt/api/open3d/orders \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": "hex-tray",
    "quantity": 1,
    "email": "agent@example.com",
    "payment_method": "card",
    "shipping_address": {
      "name": "Agent Bot",
      "line1": "Rua Example 1",
      "city": "Lisboa",
      "postal_code": "1000-001",
      "country": "PT"
    }
  }'

curl -s "https://open3d.pt/api/open3d/orders/{id}/pds?email=agent@example.com"

Quote e catálogo estão live. Checkout/pagamento/PDS devolvem contrato estável com status preview enquanto o gateway de pagamento fecha.