Minhas primeiras impressões sobre o uso de APIs REST a partir do front-end foram: simplicidade incrível na ideia, mas uma grande dor de cabeça para configurar. Eu disse a mim mesmo: “Sempre quis usar REST para CRUD de serviços, mas nunca quis lidar com sua manutenção”. Quero dizer, há a configuração do CORS, lidar com o servidor e o banco de dados, etc. Eu só quero fazer meu código de front-end com facilidade e não me preocupar com o resto.
A esse respeito, DreamFactory é, bem, um sonho. O DreamFactory permite que o senhor use uma interface agradável para hospedar e configurar armazenamento, CORS, permissões e todas as outras partes de um serviço REST!
O DreamFactory é uma plataforma de API REST gratuita e de código aberto para aplicativos móveis, da Web e de IoT. Ele gera automaticamente uma API para praticamente qualquer fonte de dados, incluindo SQL, NoSQL e serviços da Web. Uma variedade de pacotes de tempo de execução está disponível gratuitamente no Bitnami e no DreamFactory.com. Os aplicativos de amostra são fornecidos para JavaScript, dispositivos móveis nativos e uma variedade de estruturas.
Destaques da API REST do DreamFactory
Uma rápida visão geral do recursos do DreamFactory:
- Obtenha APIs REST documentadas e em tempo real para SQL, NoSQL, armazenamento de arquivos, e-mail, notificações push e serviços remotos da Web em segundos. Não é necessário codificar a API manualmente.
- Personalize o comportamento da API conforme necessário com scripts no lado do servidor em qualquer ponto de extremidade da API REST.
- Proteja cada endpoint de API com permissões de acesso granulares e baseadas em funções.
- Exemplo de código de API para JavaScript, iOS, Android, etc.
- Chame os pontos de extremidade da API de qualquer aplicativo cliente e receba JSON ou XML de volta.
- Instaladores locais de código aberto
- A versão 2.0 já está disponível!
Apresentação do gerente de produtos da DreamFactory
Uma introdução diretamente da fonte:
Os exemplos de código a seguir pressupõem que o armazenamento MySQL esteja configurado no painel de administração do DreamFactory. Ler Conectando-se a um banco de dados MySQL com JavaScript para ver o lado administrativo da configuração.
O caso de uso mais comum para mim é usar JavaScript para interagir com um backend do MySQL. O DreamFactory fornece ajudantes de API para muitas linguagens, mas, neste caso, queremos o JavaScript SDK, um conjunto de extensões para o jQuery. Essencialmente, cada função envolve um jQuery.ajax
portanto, se o senhor não usar o jQuery, poderá transcrevê-lo facilmente para a estrutura desejada.
Comece definindo seu APP_API_KEY
e INSTANCE_HOST
:
var APP_API_KEY = 'YOUR_API_KEY'; var INSTANCE_HOST = 'https://df-davidwalsh.enterprise.dreamfactory.com';
Em seguida, o senhor precisa passar as credenciais para gerar uma chave de sessão:
$.ajax({ dataType: 'json', contentType: 'application/json; charset=utf-8', url: INSTANCE_HOST + '/api/v2/user/session', data: JSON.stringify({ 'email': ACCOUNT_EMAIL_ADDRESS, 'password': ACCOUNT_PASSWORD }), method: 'POST', success: function (response) { // Handle success }, error: function (response) { // Handle error } });
Com a chave de sessão criada, agora é possível recuperar e criar registros usando a API JavaScript do DreamFactory:
// Get records from a "contacts" table // table, params, token, callback $.api.getRecords('contacts', null, session_token, function(response) { // Work with contact data here }); // Specify just the information we want back $.api.getRecords('contacts', 'fields=contact_id,email,age', session_token, function() { // Work with contact data here }); // Create a new record $.api.setRecord('contacts', JSON.stringify({ email: 'someone@somewhere.com', age: 23 }), session_token, callback);
Uma vez que a API é agradável e fácil de usar: login
, logout
, register
, getRecords
, setRecord
, updateRecord
, deleteRecord
, e replaceRecord
. Cada função centrada em registros tem a mesma assinatura (table, params, token, callback
) para que o senhor possa codificar sem pensar em fazer malabarismos com as assinaturas. Como desenvolvedor de JavaScript de longa data, posso dizer ao senhor que a codificação com assinaturas consistentes e adivinháveis ajuda a acelerar imensamente o desenvolvimento.
Recursos e suporte
A DreamFactory forneceu um uma grande quantidade de informações sobre seu produto e há vários lugares para obter inspiração e ajuda para chegar lá:
Não há falta de ajuda quando o senhor precisa.
Dê uma chance ao DreamFactory!
Depois que o senhor se acostumar com a interface do DreamFactory e tiver sua API e CORS configurados, o uso dos auxiliares das bibliotecas do DreamFactory permitirá que o senhor coloque rapidamente seu aplicativo REST em execução. Se o senhor deseja criar um aplicativo com tecnologia REST, inscreva-se no DreamFactory e explore todas as ofertas, tanto hospedadas quanto auto-hospedadas. O senhor ficará surpreso com o que encontrará!