Ferramentas

Scripts de teste

Confira todos os endpoints com a sua chave, sem escrever código.

O que fazem

Os scripts chamam os endpoints de leitura (loja, produtos, estoque, categorias, pedidos, clientes, cupons, webhooks) e mostram ✔ ou ✘ com o tempo de cada um. Com --escrita também criam uma categoria e um produto ocultos de teste, ajustam o estoque, conferem e desativam o produto no fim. Endpoints sem o escopo da chave aparecem como “sem permissão” (não é falha).

Downloads

cURL (bash)testar-api.sh · Linux, macOS, WSL, Git Bash Node.js 18+testar-api.mjs · sem dependências Python 3.8+testar_api.py · só biblioteca padrão PHP 7.4+testar-api.php · com a extensão curl Coleção do PostmanImporte e preencha a variável chave OpenAPI 3.1openapi.json · Insomnia, Swagger, geradores de SDK Receptor de webhook (Node)Servidor que confere a assinatura e mostra os eventos Receptor de webhook (PHP)Arquivo para colocar no seu servidor

Como rodar

export HDL_CHAVE="hdl_live_..."

bash testar-api.sh               # só leitura
bash testar-api.sh --escrita     # também grava (produto oculto de teste)

node testar-api.mjs --escrita
python3 testar_api.py
php testar-api.php

Chave de demonstração

Para ver a API funcionando antes de criar a sua, use a chave pública abaixo. Ela é somente leitura (loja, produtos, categorias e cupons), aceita 20 chamadas por minuto e aponta para a loja exemplo Página Dobrada.

hdl_live_0d89ec3f4713ce7ac670e12f14afb33e47194d0a12bba0da

Exemplo de saída

API do Hotel das Lojas · https://api.hoteldaslojas.com.br/v1
Loja: Página Dobrada (https://demo73.hoteldaslojas.com.br)

 ✔ GET  /loja                          200   212 ms
 ✔ GET  /produtos?por_pagina=5          200   301 ms
 ✔ GET  /produtos/2268                  200   188 ms
 ✔ GET  /produtos/2268/estoque          200   176 ms
 ✔ GET  /categorias                     200   170 ms
 – GET  /pedidos?por_pagina=5           403   sem permissão (pedidos.ler)
 – GET  /clientes?por_pagina=5          403   sem permissão (clientes.ler)
 ✔ GET  /cupons                         200   169 ms
 – GET  /webhooks                       403   sem permissão (webhooks.gerenciar)

6 ok · 0 falhas · 3 sem permissão