Descrição:
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Retorna todos os cards vinculados a um board específico utilizando seu identificador único (id).
Este endpoint permite consultar os cards pertencentes a um determinado Board dentro da plataforma, incluindo informações relacionadas aos cards, fases, responsáveis e demais dados disponíveis conforme as permissões do usuário autenticado.
É recomendado para integrações que necessitam listar, sincronizar ou monitorar cards de um Board específico.
Parâmetros utilizados
id do Board
id do BoardIdentificador único do Board que será consultado.
O ID deve ser informado diretamente na rota da requisição.
Exemplo:
GET https://api.goalfy.com.br/api/cards/board/12345Neste exemplo:
12345
Corresponde ao ID do Board consultado.
Exemplo de resposta
[
{
"id": "10001",
"title": "Goalfy",
"phase": "Em andamento",
"responsible": "Goalfy"
},
{
"id": "10002",
"title": "Goalfy",
"phase": "Concluído",
"responsible": "Goalfy"
}
]
Possíveis erros
404 Not FoundRetornado quando o Board informado não existe ou não foi localizado.
401 UnauthorizedRetornado quando o token de autenticação é inválido ou não foi enviado corretamente.
403 ForbiddenRetornado quando o usuário não possui permissão para acessar o Board informado.
Observações
ImportanteO retorno da requisição pode variar conforme as permissões do usuário autenticado.
- Alguns Boards podem não possuir cards cadastrados.
- Dependendo da configuração do Board, determinados campos podem retornar valores nulos.
- Recomenda-se utilizar filtros e paginação em integrações com grande volume de cards, quando disponível.
- Certifique-se de informar um ID válido para evitar erros de consulta.
FAQ?
Perguntas frequentes que fazem.
Segue abaixo cards que podem te ajudar a tirar essas dúvidas:
200