= Expresso Web Service =


Este ''Draft'' é destinado à especificação dos requisitos referentes à implementação do ''Web Service'' do Expresso. Todas as informações contidas neste documento poderão sofrer alterações sem aviso prévio, até o fechamento do escopo deste subprojeto do Expresso.


----
== 1. Objetivo ==



----
== 2. Compatibilidade ==

API: Versões > 2.2

ExpressoMail: Versões > 2.2

ContactCenter: Versões > 2.2


----
== 3. Arquitetura ==



----
== 4. Protocolo de Comunicação ==

JSON-RPC versão 1.0


----
== 5. Recursos disponíveis ==

||'''Método:'''||'''Expresso.login'''||Criar sessão autenticada no Expresso||
||'''Parâmetros:'''||-user\\-password\\-auth||-Login do Usuario.\\-Senha do usuario.\\-Autenticacao existente, caso ja esteja logado.||
||'''Retorno:'''||-auth||-auth: Chave de autenticacao do expresso (KP3 do usuario).||
\\
\\
||'''Método:'''||'''Expresso.logout'''||Finalizar sessão autenticada no Expresso||
||'''Parâmetros:'''||-auth||-Autenticacao existente, necessaria para destruir a sessao do usuario.||
||'''Retorno:'''||-hasLogout||-hasLogout:(Boolean 0 ou 1 indicando se o logout foi realizado com sucesso)||
\\
\\
||'''Método:'''||'''Mail.getUserFolders'''||Listar pastas de Email||
||'''Parâmetros:'''||-auth\\-search\\-page\\-resultsPerPage||auth:Autenticacao do usuario.\\search:filtro por nome de pasta\\page:pagina atual\\resultsPerPage:Numero de resultados a retornar por pagina.||
||'''Retorno:'''||-folders array(\\folderName,folderID,folderType,folderParentID,folderHasChildren,qtdMessages,qtdUnreadMessages,percentUsageOfTotalQuota,diskSize\\)||-folders:Array com todas as pastas retornadas.\\folderName:Nome da pasta.\\folderID:Caminho da pasta\\folderType:(1-Caixa de Entrada,2-Enviadas,3-Rascunhos,4-Lixeira,5-Pasta Comum,6-Pasta Compartilhada)\\folderHasChildren:(Boolean 0 ou 1)Indica se a pasta possui sub-pastas ou nao.\\qtdMessages:Quantidade de Mensagens na pasta.\\qtdUnreadMessages:Quantidade de Mensagens nao lidas.\\percentUsageOfTotalQuota:Percentual utilizado da quota do usuario para esta pasta.\\diskSize:Tamanho total da pasta utilizado do disco em Bytes.||
\\
\\
||'''Método:'''||'''Mail.getUserMessages'''||Listar mensagens de uma pasta de Email||
||'''Parâmetros:'''||-auth\\-folderID\\-search\\-page\\-resultsPerPage||auth:Autenticacao do usuario.\\search:filtro por assunto da mensagem, conteudo.\\page:pagina atual\\resultsPerPage:Numero de resultados a retornar por pagina.||
||'''Retorno:'''||-messages array(\\messageID,\\)||-messages:Array com todas as mensagens retornadas.\\messageID:Identificador da mensagem.||
\\
\\