GETDevoluções & Disputas
Listar devoluções
Lista as devoluções/trocas (paginado + filtro ?status=). Requer permissão vendas.
GET
/returnsAutenticaçãoPainel adminvendas.
Cookie de sessão do painel (ecom_token) + permissão RBAC.
Parâmetros de consulta
statusstringopcionalFiltra por status.
Cabeçalhos
CookiestringobrigatórioCookie de sessão do painel: ecom_token=<jwt> (obtido em POST /auth/login).
Requisição
curl "https://api.ecomplataforma.com.br/returns?status=solicitado" -b cookies.txtResposta200
200 OK
{ "success": true, "data": [ { "id": "r_1", "orderId": "o_501", "status": "solicitado" } ] }Respostas de erro
401Não autenticado
401 Não autenticado
{
"success": false,
"error": "Sessão ausente ou expirada."
}403Sem permissão
403 Sem permissão
{
"success": false,
"error": "Você não tem permissão para acessar este recurso."
}