Início rápido

Ao final desta página, você terá um token de acesso pessoal e uma lista dos seus produtos obtida com curl. Você precisa do curl e do jq.

1. Abra o painel

Entre em app.mobiari.com e selecione a loja que você quer acessar pelos seus scripts. O nome da loja aparece no topo da barra lateral.

2. Crie um token de acesso pessoal

Abra Tokens de API na barra lateral (no grupo de equipe / configurações) e clique em Novo token:

• Nome: qualquer nome que você reconheça depois. laptop curl serve.
• Permissões que o token pode usar: apenas o que você precisa. Para este passo a passo, products.read é suficiente.
• Expira em: deixe em Nunca por enquanto.

Confirme em Novo token. O token bruto é exibido uma única vez:

bod_8aF3K2…NvWp

export BP_TOKEN="bod_8aF3K2…NvWp"

3. Descubra o ID da sua loja

Endpoints no nível da loja recebem o UUID da loja no caminho. Liste as lojas a que você tem acesso:

curl -s https://api.mobiari.com/v1/me/access \
  -H "Authorization: Bearer $BP_TOKEN" \
  | jq '.stores[] | {store_id, store_name}'

export STORE_ID="0199a4f2-6c1e-7d3a-9b1f-3e2c8a5d7f10"

4. Faça sua primeira chamada

curl -s "https://api.mobiari.com/v1/stores/$STORE_ID/products?limit=5" \
  -H "Authorization: Bearer $BP_TOKEN" \
  | jq '.data[].title'

Isso imprime os títulos dos seus cinco primeiros produtos. Listas voltam como um Page: os itens em data, mais has_more e next_cursor para buscar a próxima página. Veja Paginação.

Se o token não tiver products.read, você recebe um 403:

{ "error": "Forbidden", "code": "forbidden" }

Volte em Tokens de API e gere um token com a permissão correta.

5. Próximos passos