Notificações
Lista as notificações do usuário logado, da mais nova para a mais antiga.
Devolve os avisos de pedido, pagamento, repasse e sistema destinados ao usuário do token (não ao seller inteiro). O texto longo é omitido para economizar dados: o app mostra o assunto.
/api/v1/vendor/mobile/notificationsSellerNotificações do usuário
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso de um usuário do painel do seller (lojista), obtido no login (veja Tokens).Parâmetros de consulta
pageintegerpadrão: 1Página, a partir de 1.
per_pageintegerpadrão: 20Itens por página. Padrão 20, máximo 50.
Exemplo de requisição
Resposta
200Notificações
Campos da resposta
notificationsarrayNotificações da página.
notifications[].iduuidId da notificação.
notifications[].typestringCategoria, por exemplo
order, payment, vendor, system.notifications[].subjectstringTítulo da notificação.
notifications[].statusstringunreadreadunread ou read.notifications[].created_atstringRFC 3339.
totalintegerNotificações do usuário.
pageintegerPágina.
per_pageintegerItens por página.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem token ou token inválido/expirado. | {"error":"missing authorization header"} / {"error":"invalid or expired token"} |
| 403 | O token não é de um usuário seller (por exemplo, é de um administrador da loja). | {"error":"insufficient permissions"} |
| 403 | O cadastro do seller ainda está em análise (só a tela de cadastro funciona até a aprovação). | {"error":"vendor_pending_review","message":"..."} |
| 500 | Falha ao consultar. | {"error":"failed to get notifications"} |