Instalação e configuração da API REST

O Firebase Realtime Database é um banco de dados hospedado na nuvem. Os dados são armazenados como JSON e sincronizados em tempo real para cada cliente conectado. Quando você cria apps multiplataforma com os nossos SDKs para Android, plataformas Apple e JavaScript, todos os seus clientes compartilham uma instância do Realtime Database e recebem atualizações automaticamente com os dados mais recentes.

É possível usar qualquer URL do Firebase Realtime Database como um endpoint REST. Para isso, basta anexar .json ao final do URL e enviar uma solicitação pelo melhor cliente HTTPS.

Criar uma conta

Primeiro, crie uma conta sem custo financeiro no console do Firebase. Um novo app do Firebase será criado para você com um URL exclusivo que termina com firebaseio.com. Você usará esse URL para autenticar seus usuários, bem como armazenar e sincronizar dados no banco de dados do app.

No console do Firebase, é possível criar, gerenciar e excluir apps do Firebase. Ao clicar em um app do Firebase específico, é possível conferir e modificar o banco de dados do app em tempo real. No painel do app, também é possível definir o Firebase Realtime Database Security Rules, gerenciar a autenticação do app, as implantações e conferir as análises.

Criar um banco de dados

  1. Acesse a seção Realtime Database do console do Firebase: Aparecerá uma solicitação para selecionar um projeto atual do Firebase. Siga o fluxo de trabalho de criação do banco de dados.

  2. Selecione um modo inicial para as Firebase Security Rules:

    Modo de teste

    Esse modo é ideal para começar a usar as bibliotecas de cliente em dispositivos móveis e na Web, mas ele permite que qualquer pessoa leia e substitua os dados. Após o teste, leia a seção Noções básicas das regras do Firebase Realtime Database.

    Selecione o modo de teste para começar a usar o SDK para Android, Apple ou Web.

    Modo bloqueado

    Nega todas as leituras e gravações de clientes de dispositivos móveis e Web. Seus servidores de aplicativos autenticados ainda podem acessar seu banco de dados.

  3. Escolha um local para o banco de dados.

    Dependendo do local, o URL do novo banco de dados terá um dos seguintes formatos:

    • DATABASE_NAME.firebaseio.com (para bancos de dados em us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (para bancos de dados em todos os outros locais)

  4. Clique em Concluído.

Quando você ativa o Realtime Database, ele também ativa a API no Gerenciador de APIs do Cloud.

Escolher uma biblioteca auxiliar

Você pode ler e gravar dados usando a API REST diretamente na linha de comando. Neste guia, usaremos o cURL para todos os nossos exemplos. Também temos várias bibliotecas auxiliares de terceiros para interagir com a API REST da sua linguagem favorita. É possível usar uma das bibliotecas auxiliares a seguir ou criar uma própria:

Idioma Bibliotecas
Clojure taika por Cloudfuji
Dart IO Client na biblioteca oficial firebase-dart
Go Firego de Steven Berlanga e Tim Gossett
Go Firebase de Cosmin Nicolaescu e Justin Tulloss
Java firebase4j por Brandon Gresham
Perl Firebase-Perl por Kiran Kumar e JT Smith
PHP firebase-php por kreait
firebase-php por Tamas Kalman
Python Pyrebase por James Childs-Maidment
python-firebase por Özgür Vatansever
python-firebase por Michael Huynh
Ruby firebase-ruby por Oscar Del Ben
BigBertha por Fernand Galiana
rest-firebase por Codementor

Próximas etapas