Lista os tickets da empresa da chave
curl --request GET \ --url 'https://public-api.mspdesk.com.br/v1/tickets?filter%5Bid%5D%5Bin%5D=1%2C2%2C3&filter%5Bcode%5D%5Bin%5D=1%2C2%2C3&filter%5Bpriority%5D%5Beq%5D=PLANNED&filter%5Bpriority%5D%5Bin%5D=PLANNED%2CLOW%2CMEDIUM%2CHIGH%2CCRITICAL&filter%5Bpriority%5D%5Bnin%5D=PLANNED%2CLOW%2CMEDIUM%2CHIGH%2CCRITICAL&filter%5Bstatus%5D%5Beq%5D=TO_DO&filter%5Bstatus%5D%5Bin%5D=TO_DO%2CIN_PROGRESS%2CPENDING%2CCOMPLETED%2CCLOSED%2CDELETED&filter%5Bstatus%5D%5Bnin%5D=TO_DO%2CIN_PROGRESS%2CPENDING%2CCOMPLETED%2CCLOSED%2CDELETED&filter%5Borigin%5D%5Beq%5D=EMAIL&filter%5Borigin%5D%5Bin%5D=EMAIL%2CRMM%2CMSP_TALKS%2CINTERNAL%2CPORTAL%2CEXTERNAL_FORM%2CAPI&filter%5Borigin%5D%5Bnin%5D=EMAIL%2CRMM%2CMSP_TALKS%2CINTERNAL%2CPORTAL%2CEXTERNAL_FORM%2CAPI&filter%5BserviceType%5D%5Beq%5D=INTERNAL&filter%5BserviceType%5D%5Bin%5D=INTERNAL%2CEXTERNAL&filter%5BserviceType%5D%5Bnin%5D=INTERNAL%2CEXTERNAL&filter%5BcustomerId%5D%5Bin%5D=1%2C2%2C3&filter%5BcustomerId%5D%5Bnin%5D=1%2C2%2C3&filter%5BbusinessUnitId%5D%5Bin%5D=1%2C2%2C3&filter%5BbusinessUnitId%5D%5Bnin%5D=1%2C2%2C3&filter%5BserviceCatalogId%5D%5Bin%5D=1%2C2%2C3&filter%5BserviceCatalogId%5D%5Bnin%5D=1%2C2%2C3&filter%5BcategoryId%5D%5Bin%5D=1%2C2%2C3&filter%5BcategoryId%5D%5Bnin%5D=1%2C2%2C3&filter%5BsubcategoryId%5D%5Bin%5D=1%2C2%2C3&filter%5BsubcategoryId%5D%5Bnin%5D=1%2C2%2C3&filter%5BagentId%5D%5Bin%5D=1%2C2%2C3&filter%5BagentId%5D%5Bnin%5D=1%2C2%2C3&filter%5BserviceGroupId%5D%5Bin%5D=1%2C2%2C3&filter%5BserviceGroupId%5D%5Bnin%5D=1%2C2%2C3&filter%5BcontactId%5D%5Bin%5D=1%2C2%2C3&filter%5BcontactId%5D%5Bnin%5D=1%2C2%2C3&filter%5BticketTypeId%5D%5Bin%5D=1%2C2%2C3&filter%5BticketTypeId%5D%5Bnin%5D=1%2C2%2C3&filter%5BtagId%5D%5Bin%5D=1%2C2%2C3&filter%5BtagId%5D%5Bnin%5D=1%2C2%2C3&filter%5BslaResponseStatus%5D%5Beq%5D=WITHOUT&filter%5BslaResponseStatus%5D%5Bin%5D=WITHOUT%2CWITHIN%2CAPPROACHING_BREACH%2CBREACHED%2CFULLFILLED%2CPAUSED&filter%5BslaSolutionStatus%5D%5Beq%5D=WITHOUT&filter%5BslaSolutionStatus%5D%5Bin%5D=WITHOUT%2CWITHIN%2CAPPROACHING_BREACH%2CBREACHED%2CFULLFILLED%2CPAUSED&filter%5BslaStatusAny%5D%5Beq%5D=WITHOUT&filter%5BslaStatusAny%5D%5Bin%5D=WITHOUT%2CWITHIN%2CAPPROACHING_BREACH%2CBREACHED%2CFULLFILLED%2CPAUSED&filter%5BstageId%5D%5Bin%5D=1%2C2%2C3&filter%5BworkflowId%5D%5Bin%5D=1%2C2%2C3&limit=25&sort=-createdAt&fields=id%2Ccode%2Csubject&expand=customer%2Cagent' \ --header 'Authorization: Bearer <token>'Escopo exigido: tickets:read. Paginação por cursor opaco (?cursor=), nunca por página/offset — use nextCursor da resposta anterior. Sem filter[deleted][eq], a listagem só traz tickets não excluídos (deleted=false); com o filtro, vale o valor pedido.
filter[customerId][..] casa todos os tickets do cliente informado, com ou sem unidade de negócio — diferente da tela do produto, que ali entende “cliente” como “deste cliente e sem unidade”. Quem quer só os sem unidade soma filter[businessUnitId][isNull]=true. O mesmo vale para serviceGroupId: aqui o filtro olha só a coluna, sem a regra de “do usuário ou sem grupo” que a tela aplica.
ne e nin incluem os registros sem valor — filter[agentId][nin]=5 também traz os tickets sem agente. Quem quer só os preenchidos soma filter[<campo>][isNull]=false.
Campo personalizado: filter[customFields.<id>][<operador>], com o operador de acordo com o tipo do campo:
| Tipo do campo | Operadores | Exemplo |
|---|---|---|
| Texto / Área de texto | contains, eq, isNull |
filter[customFields.12][contains]=urgente |
| Número inteiro | eq, gt, gte, lt, lte, isNull |
filter[customFields.12][gte]=10 |
| Número decimal | eq, gt, gte, lt, lte, isNull |
filter[customFields.12][lte]=9.5 |
| Data/hora | gte, lte, isNull |
filter[customFields.12][gte]=2026-01-01T00:00:00-03:00 |
| Lista suspensa (id da opção) | eq, in |
filter[customFields.12][in]=3,4 |
| Caixa de seleção | eq |
filter[customFields.12][eq]=true |
O campo personalizado de data/hora é gravado na hora local da empresa: o filtro converte o instante ISO-8601 informado (sempre com fuso) para o fuso da empresa antes de comparar, e a representação devolve o valor com o offset da empresa naquele instante.
Para sincronizar “o que mudou desde a última consulta”, use sort=lastActivityAt com filter[lastActivityAt][gte]=<último valor visto menos 5 minutos>, e deduplique pelo par id + lastActivityAt — um ticket relido com o mesmo par já foi processado. A margem de 5 minutos é necessária porque o carimbo é gravado de forma assíncrona, pouco depois da confirmação da escrita: sem ela, um ticket cujo carimbo demore mais para ser gravado pode nunca aparecer numa consulta seguinte. A precisão é de segundo, então mais de um ticket pode compartilhar o mesmo instante.
Autorizações
Seção intitulada “Authorizations”Parâmetros
Seção intitulada “Parameters”Parâmetros de consulta
Seção intitulada “Query Parameters”Filtra por id igual ao valor informado.
Exemplo
1,2,3Filtra por id igual a um dos valores informados, separados por vírgula (até 100).
Filtra por code igual ao valor informado.
Exemplo
1,2,3Filtra por code igual a um dos valores informados, separados por vírgula (até 100).
Filtra por subject contendo o texto informado (sem diferenciar maiúsculas de minúsculas, conforme a colação do banco).
Filtra por priority igual ao valor informado.
Exemplo
PLANNED,LOW,MEDIUM,HIGH,CRITICALFiltra por priority igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
PLANNED,LOW,MEDIUM,HIGH,CRITICALFiltra por priority diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por status igual ao valor informado.
Exemplo
TO_DO,IN_PROGRESS,PENDING,COMPLETED,CLOSED,DELETEDFiltra por status igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
TO_DO,IN_PROGRESS,PENDING,COMPLETED,CLOSED,DELETEDFiltra por status diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por origin igual ao valor informado.
Exemplo
EMAIL,RMM,MSP_TALKS,INTERNAL,PORTAL,EXTERNAL_FORM,APIFiltra por origin igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
EMAIL,RMM,MSP_TALKS,INTERNAL,PORTAL,EXTERNAL_FORM,APIFiltra por origin diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por serviceType igual ao valor informado.
Exemplo
INTERNAL,EXTERNALFiltra por serviceType igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
INTERNAL,EXTERNALFiltra por serviceType diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por customerId igual ao valor informado.
Exemplo
1,2,3Filtra por customerId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por customerId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por customerId ter ou não valor: true sem valor; false com valor.
Filtra por businessUnitId igual ao valor informado.
Exemplo
1,2,3Filtra por businessUnitId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por businessUnitId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por businessUnitId ter ou não valor: true sem valor; false com valor.
Filtra por serviceCatalogId igual ao valor informado.
Exemplo
1,2,3Filtra por serviceCatalogId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por serviceCatalogId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por serviceCatalogId ter ou não valor: true sem valor; false com valor.
Filtra por categoryId igual ao valor informado.
Exemplo
1,2,3Filtra por categoryId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por categoryId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por categoryId ter ou não valor: true sem valor; false com valor.
Filtra por subcategoryId igual ao valor informado.
Exemplo
1,2,3Filtra por subcategoryId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por subcategoryId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por subcategoryId ter ou não valor: true sem valor; false com valor.
Filtra por agentId igual ao valor informado.
Exemplo
1,2,3Filtra por agentId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por agentId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por agentId ter ou não valor: true sem valor; false com valor.
Filtra por serviceGroupId igual ao valor informado.
Exemplo
1,2,3Filtra por serviceGroupId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por serviceGroupId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por serviceGroupId ter ou não valor: true sem valor; false com valor.
Filtra por contactId igual ao valor informado.
Exemplo
1,2,3Filtra por contactId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por contactId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por contactId ter ou não valor: true sem valor; false com valor.
Filtra por ticketTypeId igual ao valor informado.
Exemplo
1,2,3Filtra por ticketTypeId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por ticketTypeId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por ticketTypeId ter ou não valor: true sem valor; false com valor.
Filtra por tagId igual ao valor informado.
Exemplo
1,2,3Filtra por tagId igual a um dos valores informados, separados por vírgula (até 100).
Exemplo
1,2,3Filtra por tagId diferente de todos os valores informados, separados por vírgula (até 100; inclui registros sem valor).
Filtra por tagId ter ou não valor: true sem valor; false com valor.
Filtra por slaResponseStatus igual ao valor informado.
Exemplo
WITHOUT,WITHIN,APPROACHING_BREACH,BREACHED,FULLFILLED,PAUSEDFiltra por slaResponseStatus igual a um dos valores informados, separados por vírgula (até 100).
Filtra por slaSolutionStatus igual ao valor informado.
Exemplo
WITHOUT,WITHIN,APPROACHING_BREACH,BREACHED,FULLFILLED,PAUSEDFiltra por slaSolutionStatus igual a um dos valores informados, separados por vírgula (até 100).
Filtra por slaStatusAny igual ao valor informado.
Exemplo
WITHOUT,WITHIN,APPROACHING_BREACH,BREACHED,FULLFILLED,PAUSEDFiltra por slaStatusAny igual a um dos valores informados, separados por vírgula (até 100).
Filtra por createdById igual ao valor informado.
Filtra por followerId igual ao valor informado.
Filtra por answered igual ao valor informado.
Filtra por deleted igual ao valor informado.
Filtra por createdAt maior ou igual ao valor informado.
Filtra por createdAt menor ou igual ao valor informado.
Filtra por solvedAt maior ou igual ao valor informado.
Filtra por solvedAt menor ou igual ao valor informado.
Filtra por updatedAt maior ou igual ao valor informado.
Filtra por updatedAt menor ou igual ao valor informado.
Filtra por lastActivityAt maior ou igual ao valor informado.
Filtra por lastActivityAt menor ou igual ao valor informado.
Filtra por stageId igual ao valor informado.
Exemplo
1,2,3Filtra por stageId igual a um dos valores informados, separados por vírgula (até 100).
Filtra por stageId ter ou não valor: true sem valor; false com valor.
Filtra por workflowId igual ao valor informado.
Exemplo
1,2,3Filtra por workflowId igual a um dos valores informados, separados por vírgula (até 100).
Filtra por workflowId ter ou não valor: true sem valor; false com valor.
Itens por página. 1 a 100; padrão 25.
Cursor opaco da próxima página, devolvido em nextCursor da resposta anterior. Omita na primeira página.
Campo de ordenação: id, code, createdAt, updatedAt, lastActivityAt (padrão id). Prefixe com - para descendente (ex.: sort=-createdAt); sempre desempatado por id na mesma direção. Tickets cujo lastActivityAt ainda não foi preenchido não aparecem em listagens ordenadas ou filtradas por lastActivityAt; a contagem (GET /v1/tickets/count) sem esse filtro os inclui normalmente, então as duas podem divergir por alguns instantes.
Exemplo
-createdAtCampos de primeiro nível a retornar, separados por vírgula (id sempre volta): id, code, subject, description, status, priority, origin, answered, reopened, deleted, createdAt, updatedAt, lastActivityAt, respondedAt, solvedAt, closedAt, deletedAt, slaResponseStatus, slaSolutionStatus, slaResponseDueAt, slaSolutionDueAt, customerId, businessUnitId, contactId, agentId, serviceGroupId, serviceCatalogId, categoryId, subcategoryId, ticketTypeId, assetId, workflowId, stageId, createdById, followUpOfId, mergedIntoId, tagIds, customFields.
Exemplo
id,code,subjectObjetos a acrescentar à resposta, separados por vírgula, até 3 por requisição: customer (escopo customers:read), contact (escopo contacts:read), agent (escopo agents:read), serviceGroup (escopo settings:read). Sem o escopo exigido de algum item pedido: 403 insufficient_scope.
Exemplo
customer,agentRespostas
Seção intitulada “Responses”Página de tickets
object
object
ID do agente responsável pelo ticket; null se não atribuído.
Indica se o ticket já foi respondido ao menos uma vez.
ID do ativo vinculado ao ticket; null se não vinculado a um ativo.
ID da unidade de negócio do cliente; null se o ticket não está vinculado a uma unidade.
ID da categoria do ticket; null se não categorizado.
Data e hora do fechamento do ticket, em UTC; null se ainda não fechado.
Número do ticket, visível ao agente e ao cliente (diferente do id).
ID do contato que abriu ou representa o ticket; null se não houver contato.
Data e hora de criação do ticket, em UTC.
ID do usuário que criou o ticket; null se criado sem um usuário (ex.: por e-mail).
Valores dos campos personalizados do ticket. Só entra um item por campo com valor preenchido; campo sem valor não aparece na lista.
Valor de um campo personalizado do ticket.
object
ID do campo personalizado.
Nome do campo personalizado.
Tipo do campo personalizado — governa o formato de value.
Valor do campo, no formato do tipo (type):
| Tipo | Formato de value |
|---|---|
TEXT, TEXT_AREA |
string |
INTEGER |
integer |
DECIMAL |
number |
DATETIME |
string date-time, com o offset da empresa no instante do valor |
CHECKBOX |
boolean |
DROPDOWN |
objeto {id, label} da opção selecionada; {id: null, label: <valor gravado>} quando a opção não existe mais |
object
ID do cliente do ticket; null se não vinculado a um cliente.
Indica se o ticket foi excluído. Sem filter[deleted][eq], a listagem só traz false; GET /v1/tickets/{id} devolve também o excluído, com deleted: true.
Data e hora da exclusão do ticket, em UTC; null se não excluído.
Descrição da abertura do ticket.
ID do ticket original, quando este é um desdobramento (follow-up); null caso contrário.
Identificador interno do ticket.
Última atividade no ticket: mudança na linha do ticket ou escrita em nota, resposta, encaminhamento, apontamento, tarefa, item faturável, anexo, seguidor, conversa do MSP Talks, pausa de SLA, campo personalizado ou tags. Precisão de segundo. Pode vir nulo por alguns milissegundos logo após a criação do ticket.
ID do ticket no qual este foi mesclado; null se não foi mesclado.
Canal de origem do ticket (e-mail, portal, telefone etc.).
Prioridade do ticket.
Indica se o ticket já foi reaberto.
Data e hora da primeira resposta ao ticket, em UTC; null se ainda não respondido.
ID do serviço do catálogo vinculado ao ticket; null se não vinculado.
ID do grupo de atendimento do ticket; null se não vinculado a um grupo.
Prazo do SLA de resposta, em UTC; null se o ticket não tem SLA de resposta.
Status do SLA de resposta; null se o ticket não tem SLA de resposta.
Prazo do SLA de solução, em UTC; null se o ticket não tem SLA de solução.
Status do SLA de solução; null se o ticket não tem SLA de solução.
Data e hora da solução do ticket, em UTC; null se ainda não solucionado.
ID da etapa atual do ticket dentro do fluxo; null se o ticket não estiver em um fluxo.
Status atual do ticket.
ID da subcategoria do ticket; null se não vinculado a uma subcategoria.
Assunto do ticket.
IDs das tags aplicadas ao ticket.
ID do tipo do ticket; null se não definido.
Data e hora da última atualização da linha do ticket, em UTC.
ID do fluxo de trabalho aplicado ao ticket; null se nenhum fluxo estiver aplicado.
object
E-mail do agente.
ID do agente.
Nome e sobrenome do agente.
object
E-mail do contato; null se não cadastrado.
ID do contato.
Nome do contato.
object
Nome fantasia do cliente; null se não cadastrado.
ID do cliente.
Razão social do cliente.
object
ID do grupo de serviço.
Nome do grupo de serviço.
Cursor opaco da próxima página; null quando não há mais páginas.
Exemplo
{ "data": [ { "agentId": 42, "answered": true, "assetId": 310, "businessUnitId": 3, "categoryId": 6, "closedAt": null, "code": 18342, "contactId": 88, "createdAt": "2026-01-10T12:00:00Z", "createdById": null, "customFields": [ { "id": 12, "name": "Patrimônio", "type": "TEXT", "value": "PAT-00731" } ], "customerId": 15, "deleted": false, "deletedAt": null, "description": "<p>A impressora do financeiro não aparece na rede desde a troca do roteador.</p>", "followUpOfId": null, "id": 1042, "lastActivityAt": "2026-01-10T14:05:00Z", "mergedIntoId": null, "origin": "EMAIL", "priority": "HIGH", "reopened": false, "respondedAt": "2026-01-10T12:40:00Z", "serviceCatalogId": 9, "serviceGroupId": 4, "slaResponseDueAt": "2026-01-10T13:00:00Z", "slaResponseStatus": "FULLFILLED", "slaSolutionDueAt": "2026-01-10T20:00:00Z", "slaSolutionStatus": "WITHIN", "solvedAt": null, "stageId": 12, "status": "IN_PROGRESS", "subcategoryId": 21, "subject": "Impressora sem conexão", "tagIds": [ 1 ], "ticketTypeId": 2, "updatedAt": "2026-01-10T14:05:00Z", "workflowId": 5 } ], "nextCursor": "eyJpZCI6MTA0Mn0"}Cabeçalhos
Seção intitulada “Headers”Capacidade do balde mais restritivo consumido nesta requisição
Requisições restantes nesse balde
Segundos até o balde encher de novo
Requisição malformada ou parâmetros de consulta inválidos
Erro no formato RFC 9457 (application/problem+json).
object
Código estável do erro, para tratamento programático.
Explicação legível deste erro específico.
Erros de campo — presente quando a falha vem de validação de campo.
object
Código estável do erro de campo.
Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.
Mensagem traduzida no locale da requisição.
Presente só no 429
Presente só quando layer=operation
Identificador da requisição — informe-o ao suporte ao reportar um erro.
Presente só no 403 insufficient_scope
Status HTTP da resposta.
Título curto e legível do erro.
URI que identifica o tipo do erro.
Exemplo
{ "code": "not_found", "detail": "O recurso solicitado não foi encontrado.", "errors": [ { "code": "required" } ], "layer": "ip", "operation": "report", "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55", "status": 404, "title": "Recurso não encontrado", "type": "https://developers.mspdesk.com.br/erros/#not_found"}Cabeçalhos
Seção intitulada “Headers”Capacidade do balde mais restritivo consumido nesta requisição
Requisições restantes nesse balde
Segundos até o balde encher de novo
Chave de API ausente, inválida, revogada ou expirada
Erro no formato RFC 9457 (application/problem+json).
object
Código estável do erro, para tratamento programático.
Explicação legível deste erro específico.
Erros de campo — presente quando a falha vem de validação de campo.
object
Código estável do erro de campo.
Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.
Mensagem traduzida no locale da requisição.
Presente só no 429
Presente só quando layer=operation
Identificador da requisição — informe-o ao suporte ao reportar um erro.
Presente só no 403 insufficient_scope
Status HTTP da resposta.
Título curto e legível do erro.
URI que identifica o tipo do erro.
Exemplo
{ "code": "not_found", "detail": "O recurso solicitado não foi encontrado.", "errors": [ { "code": "required" } ], "layer": "ip", "operation": "report", "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55", "status": 404, "title": "Recurso não encontrado", "type": "https://developers.mspdesk.com.br/erros/#not_found"}Acesso negado: empresa inativa (account_inactive), API pública desabilitada para a empresa (public_api_disabled), escopo liberado só com a API pública (scope_requires_public_api) ou escopo insuficiente (insufficient_scope)
Erro no formato RFC 9457 (application/problem+json).
object
Código estável do erro, para tratamento programático.
Explicação legível deste erro específico.
Erros de campo — presente quando a falha vem de validação de campo.
object
Código estável do erro de campo.
Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.
Mensagem traduzida no locale da requisição.
Presente só no 429
Presente só quando layer=operation
Identificador da requisição — informe-o ao suporte ao reportar um erro.
Presente só no 403 insufficient_scope
Status HTTP da resposta.
Título curto e legível do erro.
URI que identifica o tipo do erro.
Exemplo
{ "code": "not_found", "detail": "O recurso solicitado não foi encontrado.", "errors": [ { "code": "required" } ], "layer": "ip", "operation": "report", "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55", "status": 404, "title": "Recurso não encontrado", "type": "https://developers.mspdesk.com.br/erros/#not_found"}Cabeçalhos
Seção intitulada “Headers”Capacidade do balde mais restritivo consumido nesta requisição
Requisições restantes nesse balde
Segundos até o balde encher de novo
Limite de uso atingido (rate_limited); o campo layer indica a camada: ip, company, key, operation ou concurrency
Erro no formato RFC 9457 (application/problem+json).
object
Código estável do erro, para tratamento programático.
Explicação legível deste erro específico.
Erros de campo — presente quando a falha vem de validação de campo.
object
Código estável do erro de campo.
Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.
Mensagem traduzida no locale da requisição.
Presente só no 429
Presente só quando layer=operation
Identificador da requisição — informe-o ao suporte ao reportar um erro.
Presente só no 403 insufficient_scope
Status HTTP da resposta.
Título curto e legível do erro.
URI que identifica o tipo do erro.
Exemplo
{ "code": "not_found", "detail": "O recurso solicitado não foi encontrado.", "errors": [ { "code": "required" } ], "layer": "ip", "operation": "report", "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55", "status": 404, "title": "Recurso não encontrado", "type": "https://developers.mspdesk.com.br/erros/#not_found"}Cabeçalhos
Seção intitulada “Headers”Capacidade do balde mais restritivo consumido nesta requisição
Requisições restantes nesse balde
Segundos até o balde encher de novo
Segundos até poder repetir
Erro interno inesperado
Erro no formato RFC 9457 (application/problem+json).
object
Código estável do erro, para tratamento programático.
Explicação legível deste erro específico.
Erros de campo — presente quando a falha vem de validação de campo.
object
Código estável do erro de campo.
Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.
Mensagem traduzida no locale da requisição.
Presente só no 429
Presente só quando layer=operation
Identificador da requisição — informe-o ao suporte ao reportar um erro.
Presente só no 403 insufficient_scope
Status HTTP da resposta.
Título curto e legível do erro.
URI que identifica o tipo do erro.
Exemplo
{ "code": "not_found", "detail": "O recurso solicitado não foi encontrado.", "errors": [ { "code": "required" } ], "layer": "ip", "operation": "report", "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55", "status": 404, "title": "Recurso não encontrado", "type": "https://developers.mspdesk.com.br/erros/#not_found"}Cabeçalhos
Seção intitulada “Headers”Capacidade do balde mais restritivo consumido nesta requisição
Requisições restantes nesse balde
Segundos até o balde encher de novo