Programadores

Uma API de comércio sobre a qual construir sem surpresas.

Tudo o que o painel faz passa pela mesma API REST que recebe: um único documento OpenAPI 3.1 contract-first, erros RFC 7807, montantes em cêntimos inteiros e uma base de dados isolada por loja.

Programadores

API REST

Contract-first, não documentação a posteriori.

O documento OpenAPI 3.1 é a fonte de verdade: os esquemas de pedido e resposta são tipados e validados contra ele, e a referência interativa Scalar em api.inaishop.com/docs é gerada a partir desse mesmo documento — a documentação não pode desviar-se da API.

  • Contrato OpenAPI 3.1, público em api.inaishop.com/openapi.json
  • Erros como problem details RFC 7807 — legíveis por máquina, sempre
  • Cada montante monetário é um inteiro em cêntimos — nunca floats

Webhooks v2

Dezanove eventos, entregues como os construiria.

Subscreva eventos de encomendas, produtos, clientes, pagamentos, subscrições, carrinho, avaliações e inventário. As repetições seguem as suas regras — backoff exponencial ou linear —, qualquer entrega pode ser reenviada, e cada pedido leva um cabeçalho traceparent do W3C para rastreio de ponta a ponta.

  • Repetições configuráveis: backoff exponencial ou linear
  • Reenvie qualquer entrega depois de o seu endpoint ter estado em baixo
  • Cabeçalho traceparent do W3C em cada entrega

Os 19 eventos

  • order.created
  • order.updated
  • order.cancelled
  • order.fulfilled
  • order.refunded
  • product.created
  • product.updated
  • product.deleted
  • customer.created
  • customer.updated
  • payment.succeeded
  • payment.failed
  • payment.refunded
  • subscription.created
  • subscription.cancelled
  • subscription.renewed
  • cart.abandoned
  • review.created
  • inventory.low

O resto da superfície

Scopes, metafields, agentes e um sandbox.

As peças à volta da API que tornam uma integração vivível — todas disponíveis hoje.

  • Chaves de API com 14 scopes, default-deny

    As chaves levam scopes granulares — produtos, encomendas, clientes, catálogo, webhooks, analítica, definições e faturas, leitura e escrita. O que não concedeu é negado, e esse comportamento default-deny é ele próprio verificado por testes.

  • Metafields

    Anexe os seus próprios dados estruturados a produtos e clientes — o estado da integração vive no registo a que pertence, não numa base de dados à parte.

  • Uma superfície agêntica

    Servidor MCP (6 ferramentas), manifesto UCP assinado em /.well-known/ucp.json, checkout ACP, mandatos AP2, llms.txt e agent-feed.jsonl — a sua integração pode ser, simplesmente, um agente de IA.

  • Lojas sandbox

    Desenvolva contra uma loja sandbox que é reposta todos os dias — parta coisas à vontade, faça demonstrações em segurança e nunca toque em dados de produção.

Pronto para abrir a sua loja?

Crie a sua conta hoje — a sua montra pode estar a receber encomendas esta tarde.