Visão geral

A zankh Open API é a porta para integrar o seu sistema à rede zankh: cadastrar a sua loja, publicar e atualizar o catálogo, acompanhar os pedidos e devolver o código de rastreio de cada envio. É REST comum — HTTP, JSON e uma chave no cabeçalho —, em qualquer linguagem, sem aprovação prévia e sem SDK obrigatório.

Ela é deliberadamente não o tRPC que a plataforma usa por dentro. Quem chega aqui está ligando um ERP, um script de importação ou uma ferramenta de IA, e o contrato precisa ser entediante: POST, GET, Bearer, data, error.

O que dá para fazer

• Criar uma loja com uma única chamada, sem autenticação — e receber a primeira chave de API na resposta.
• Publicar o catálogo: criar, atualizar, desativar produtos e definir estoque absoluto.
• Ler e gerenciar pedidos, com comprador, endereço estruturado e itens.
• Devolver o rastreio de cada envio, para que o comprador seja avisado pelos canais da zankh.
• Conectar uma IA ao mesmo catálogo pelo servidor MCP, sem escrever script nenhum.
• Integrar como fornecedor (parceiro), oferecendo o seu catálogo ao agente de compras da zankh.

Onde os seus produtos aparecem

Uma loja criada pela API nasce como vendedora do marketplace zankh (sellerType: marketplace_only): o catálogo entra na vitrine de zankh.com.br, no super-app de compras e no alcance do agente de compras — sem você montar uma vitrine própria. A vitrine com domínio próprio existe e é outro plano; não é pré-requisito para vender.

Três passos

1. Cadastre a sua loja e guarde a chave zk_live_... que volta na resposta.
2. Publique os produtos — um POST /v1/products por item, ou peça para a sua IA fazer pelo MCP.
3. Acompanhe os pedidos e devolva o rastreio de cada envio.