Pular para o conteúdo principal

Formato de resposta de erro

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description",
    "details": []
  }
}

Códigos de status HTTP

CódigoSignificadoQuando acontece
400Bad RequestCorpo ou parâmetros de requisição inválidos
401UnauthorizedAutenticação ausente ou inválida
403ForbiddenAutenticado mas com permissões insuficientes
404Not FoundRecurso não existe ou não está acessível
409ConflictRecurso já existe (ex: SKU duplicado)
413Payload Too LargeUpload de arquivo excede o limite de tamanho
429Too Many RequestsLimite de taxa excedido
500Internal Server ErrorErro inesperado do servidor

Códigos de erro comuns

CódigoDescrição
VALIDATION_ERRORCorpo da requisição falhou na validação
UNAUTHORIZEDChave de API inválida
FORBIDDENPermissões de função insuficientes
NOT_FOUNDRecurso não encontrado
CONFLICTRecurso duplicado
RATE_LIMITEDMuitas requisições
PLAN_LIMIT_EXCEEDEDLimite do plano do workspace atingido
INTERNAL_ERRORErro do servidor — contate o suporte
Last modified on February 16, 2026