Através da lista de recursos abaixo, você poderá realizar testes no ambiente de demonstração
da API REST disponibilizada pelo Expresso.
Atualmente os seguintes recursos estão disponibilizados:
Login - Realiza a autenticação do usuário, gerando uma chave de autenticação;
Logout - Desloga o usuário, invalidando a chave de autenticação;
ExpressionVersion - para verificar a versão atual do Expresso;
Mail/Folders - Lista a Pasta do Usuário;
Mail/AddFolder - Adiciona uma nova pasta;
Mail/Messages - Retornas as mensagens do usuário;
Mail/Attachment - Retorna o anexo da mensagem para o download;
Mail/Send - Envia uma mensagem de email;
Mail/RenameFolder - Renomeia uma pasta;
Mail/DelFolder - Exclui uma pasta;
Mail/CleanTrash - Limpa a lixeira;
Mail/SendSupportFeedback - Envia uma mensagem de sugestão para o administrador do Expresso;
Catalog/Contacts - Retorna os contatos do catálogo pessoal e geral;
Catalog/ContactPicture - Retorna a foto de um contato em BASE64;
Calendar/Events - Retorna os eventos do calendário;
Admin/CreateUser - Criação de usuários (necessário ter permissão de acesso no módulo expressoAdmin).
Admin/SearchUser - Procura de usuários (necessário ter permissão de acesso no módulo expressoAdmin).
Admin/DeleteUser - Exclusão de usuários (necessário ter permissão de acesso no módulo expressoAdmin).
Admin/EditUser - Edição de usuários (necessário ter permissão de acesso no módulo expressoAdmin).
Admin/RenameUser - Renomeação de usuários (necessário ter permissão de acesso no módulo expressoAdmin).
Admin/UpdateUser - Atualização de usuários (necessário ter permissão de acesso no módulo expressoAdmin).
COMO FUNCIONA A API REST
Para ter acesso a um dos recursos listados acima, é necessário que sua aplicação realize uma
requisição HTTP pelos métodos( GET, POST ), para a URL que é formado pelo
endereço do servidor Expresso mais o nome do recurso que deseja utilizar.
Cada recurso possui um conjunto de parâmetros que são necessários para atender as requisições enviadas
ao servidor do Expresso.
Com exceção do recurso ExpressionVersion, todos os outros recursos necessitam de uma
autenticação ( usuário e senha, que retornará uma chave de acesso ).
Informe a URL de contexto da sua API:
Chave de Autenticação
USUÁRIO NÃO AUTENTICADO
Um exemplo de código de uma chamada AJAX, utilizando a Jquery. Este trecho de código abaixo representa
uma chamada para o Resource ExpressoVersion.
Este método retorna a versão do Expresso. Veja este exemplo funcionando em sua máquina baixando este projeto PROJETO.ZIP.
Enviando as informações com Javascript
$.ajax(
{
type : "POST",
url : "client_rest.php",
data :
{
params : {},
serverUrl : "http://expresso.pr.gov.br/api/rest/ExpressoVersion",
methodType : "POST"
},
beforeSend: function()
{
// Coloque aqui seu código;
},
success: function(response)
{
//Coloque aqui seu código;
},
error: function(response)
{
//Coloque aqui seu código;
}
};