Pular para o conteúdo
MovvioDocsapi.movvio.com.br/v1

Quickstart

Crie uma chave de API e faça sua primeira chamada à API da Movvio.

1. Crie uma chave#

Na Movvio, abra Configurações → Chaves de API. Só quem tem o papel Manager na loja vê essa página e cria chaves.

Clique em Nova chave, dê um nome para a chave e marque as permissões. Para seguir este guia, marque store:read e orders:read.

A chave aparece uma vez só, logo depois de criada. Ela começa com mvk_live_. Clique em Copiar chave e guarde num lugar seguro. Se perder, revogue e crie outra.

Cada loja pode ter até 10 chaves ativas.

2. Guarde a chave no servidor#

Deixe a chave numa variável de ambiente ou num cofre de segredos do seu servidor, nunca no código.

export MOVVIO_API_KEY="mvk_live_xxx"

3. Faça a primeira chamada#

GET/v1/store

Envie a chave no header Authorization com o prefixo Bearer. Os exemplos usam mvk_live_xxx no lugar da sua chave.

GET /v1/store devolve a loja da chave. Se a resposta trouxer o nome da sua loja, a chave está funcionando.

GET/v1/store
curl "https://api.movvio.com.br/v1/store" \
  -H "Authorization: Bearer mvk_live_xxx"
Resposta200 OK
{
  "id": "3a2b1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
  "name": "Loja Exemplo"
}

4. Liste os pedidos#

GET/v1/orders

GET /v1/orders devolve os pedidos da loja, do mais novo para o mais antigo, 25 por página.

Próximos passos:

GET/v1/orders?limit=25
curl "https://api.movvio.com.br/v1/orders?limit=25" \
  -H "Authorization: Bearer mvk_live_xxx"
Resposta200 OK
{
  "data": [
    {
      "id": "0b7e2a1c-4f5d-4c3e-9a8b-1d2e3f4a5b6c",
      "order_number": "1042",
      "external_order_id": "98765",
      "customer_name": "Cliente Exemplo",
      "total": "129.90",
      "status": "driver_assigned",
      "external_source": "bling",
      "ordered_at": "2026-10-30",
      "created_at": "2026-10-30T14:05:12.345Z"
    }
  ],
  "has_more": true,
  "next_cursor": "MjAyNi0xMC0zMFQxNDowNToxMi4zNDU2NzhafDBiN2Uy..."
}