GET
https://www.allpost.com.br/api/v1/pedido/{numeroPedido}/anexos
Lista anexos (documentos e imagens) de um pedido de reversa ou envio (numeroPedido: 1578397 ou rvs0_1578397)
Módulo: Pedido
Descrição
Lista os anexos vinculados a um pedido.
O mesmo endpoint atende pedidos de reversa e de envio. O identificador informado é o numeroPedido — número do pedido ou número do pedido de reversa (ex.: 1578397 ou rvs0_1578397).
Exemplo:
- https://www.allpost.com.br/api/v1/pedido/1578397/anexos
- https://www.allpost.com.br/api/v1/pedido/rvs0_1578397/anexos
Um anexo pode ser um documento (doc, docx, pdf, xls, xlsx, csv) ou uma imagem (jpeg, png, gif). A listagem retorna documentos e imagens em uma única lista.
Os anexos são isolados por loja: somente os anexos de pedidos pertencentes à loja autenticada pelo token são retornados.
Caso o pedido não possua anexos, o retorno é {"anexos": []}.
Códigos de retorno:
- 200: sucesso.
- 401: token ausente, expirado ou inválido.
- 403: o pedido não pertence à loja autenticada.
- 404: pedido não encontrado.
O mesmo endpoint atende pedidos de reversa e de envio. O identificador informado é o numeroPedido — número do pedido ou número do pedido de reversa (ex.: 1578397 ou rvs0_1578397).
Exemplo:
- https://www.allpost.com.br/api/v1/pedido/1578397/anexos
- https://www.allpost.com.br/api/v1/pedido/rvs0_1578397/anexos
Um anexo pode ser um documento (doc, docx, pdf, xls, xlsx, csv) ou uma imagem (jpeg, png, gif). A listagem retorna documentos e imagens em uma única lista.
Os anexos são isolados por loja: somente os anexos de pedidos pertencentes à loja autenticada pelo token são retornados.
Caso o pedido não possua anexos, o retorno é {"anexos": []}.
Códigos de retorno:
- 200: sucesso.
- 401: token ausente, expirado ou inválido.
- 403: o pedido não pertence à loja autenticada.
- 404: pedido não encontrado.
Parâmetros de Path
| Campo | Descrição | Tipo | Obrigatório |
| numeroPedido | Número do pedido ou número do pedido de reversa (ex.: 1578397 ou rvs0_1578397). Atende reversa e envio. | string | sim |
Parâmetros de Retorno
| Campo | Descrição | Tipo |
| anexos | Lista de anexos do pedido (documentos e imagens). Vazia quando não há anexos. | array |
| anexos[].url | Caminho/URL do arquivo no armazenamento. | string |
| anexos[].nome | Nome do arquivo. | string |
| anexos[].data | Data/hora do upload em ISO 8601 (YYYY-MM-DDTHH:mm:ss). | string |
| anexos[].idUsuario | Identificador do usuário que enviou o anexo. | inteiro |
| anexos[].nomeUsuario | Nome do usuário que enviou o anexo. | string |
| anexos[].idTransportadora | Identificador da transportadora quando o anexo foi enviado por um usuário de transportadora; nulo quando enviado pela loja. | inteiro |
Response
{
"anexos": [
{
"url": "rastreio/anexos/665f1c2a/nota.pdf",
"nome": "nota.pdf",
"data": "2025-01-15T10:00:00",
"idUsuario": 87,
"nomeUsuario": "Atendente HelpyGo",
"idTransportadora": null
},
{
"url": "rastreio/anexos/665f1c2a/foto.png",
"nome": "foto.png",
"data": "2025-01-15T10:05:00",
"idUsuario": 210,
"nomeUsuario": "Operador Transportadora",
"idTransportadora": 45
}
]
}
// Quando o pedido nao possui anexos:
{
"anexos": []
}