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.createdorder.updatedorder.cancelledorder.fulfilledorder.refundedproduct.createdproduct.updatedproduct.deletedcustomer.createdcustomer.updatedpayment.succeededpayment.failedpayment.refundedsubscription.createdsubscription.cancelledsubscription.renewedcart.abandonedreview.createdinventory.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.