API Reference

Códigos de erro

Códigos de erro podem ser retornados junto com um status de falha pela API. Eles podem auxiliar tratativas customizadas e explicar de forma mais granular o erro ocorrido.

Estes códigos são um trabalho em constante desenvolvimento e deverão crescer com o tempo.

CódigoDescrição
0Não informado (Na maioria dos casos este código é omitido)
1Erro desconhecido
1001Mensagem já arquivada
1002Mensagem já aprovada
1003Mensagem já respondida

Os códigos de erro são retornados em uma lista no campo "errorCodes" e também são concatenados no inicio das mensagens de erro conforme exemplo abaixo:

{
    "title": "One or more validation errors occurred.",
    "status": 400,
    "instance": "/api/v1/Room/3eb32f0b-2456-4a5d-9b05-775fd6360bfe/QuestionAnswer/ff3ce3d2-7ac4-4046-b0ac-efad7671efba",
    "traceId": "40000028-0006-fc00-b63f-84710c7967bb",
    "errorCodes": [
        1003
    ],
    "errors": {
        "RoomMessage": [
            "1003 - A pergunta já possui uma resposta."
        ]
    }
}

Algumas mensagens de erro podem não possuir um "errorCode" atrelado à ela, neste caso a mensagem não possuirá um código concatenado no inicio e não haverá um código correspondente na lista "errorCode" conforme exemplo abaixo:

{
    "title": "One or more validation errors occurred.",
    "status": 400,
    "instance": "/api/v1/Room/3eb32f0b-2456-4a5d-9b05-775fd6360bfe/QuestionAnswer/ff3ce3d2-7ac4-4046-b0ac-efad7671efba",
    "traceId": "40000028-0006-fc00-b63f-84710c7967bb",
    "errorCodes": [
        1003,
        1001
    ],
    "errors": {
        "RoomMessage": [
            "1003 - A pergunta já possui uma resposta.",
            "1001 - A Mensagem que está tentando responder já está arquivada.",
            "Mensagem do erro que não possui código."
        ]
    }
}