התקנה & הגדרה של API ל-REST

Firebase Realtime Database הוא מסד נתונים שמתארח בענן. הנתונים מאוחסנים כ-JSON ומסונכרנים בזמן אמת עם כל לקוח מחובר. כשאתם מפתחים אפליקציות לפלטפורמות שונות באמצעות ערכות ה-SDK שלנו ל-Android, לפלטפורמות של Apple ול-JavaScript, כל הלקוחות שלכם משתפים מופע אחד של Realtime Database ומקבלים באופן אוטומטי עדכונים עם הנתונים העדכניים ביותר.

אנחנו יכולים להשתמש בכל כתובת URL מסוג Firebase Realtime Database כנקודת קצה ל-REST. כל מה שצריך לעשות הוא לצרף את .json לסוף כתובת ה-URL ולשלוח בקשה מלקוח ה-HTTPS המועדף עלינו.

יצירת חשבון

קודם צריך להירשם לחשבון ללא עלות במסוף Firebase. המערכת תיצור בשבילכם אפליקציית Firebase חדשה עם כתובת URL ייחודית שמסתיימת ב-firebaseio.com. תשתמשו בכתובת ה-URL הזו כדי לאמת את המשתמשים ולשמור ולסנכרן נתונים במסד הנתונים של האפליקציה.

במסוף Firebase אפשר ליצור, לנהל ולמחוק אפליקציות Firebase. לחיצה על אפליקציה ספציפית ב-Firebase מאפשרת לכם להציג ולשנות את מסד הנתונים של האפליקציה בזמן אמת. בלוח הבקרה של האפליקציה אפשר גם להגדיר את Firebase Realtime Database Security Rules, לנהל את האימות של האפליקציה, את הפריסות שלה ולצפות בניתוח נתונים.

יצירת מסד נתונים

  1. עוברים לקטע Realtime Database במסוף Firebase. תתבקשו לבחור פרויקט קיים ב-Firebase. פועלים לפי תהליך העבודה ליצירת מסד נתונים.

  2. בוחרים מצב התחלה ל-Firebase Security Rules:

    מצב בדיקה

    מתאים לתחילת העבודה עם ספריות הלקוח לנייד ולאינטרנט, אבל מאפשר לכל אחד לקרוא את הנתונים ולכתוב עליהם. אחרי הבדיקה, חשוב לקרוא את הקטע הסבר על הכללים של Firebase Realtime Database.

    כדי להתחיל בעבודה עם SDK לאינטרנט, ל-Apple או ל-Android, בוחרים באפשרות testmode.

    מצב נעילה

    דחייה של כל פעולות הקריאה והכתיבה מלקוחות בנייד ומלקוחות אינטרנט. שרתי האפליקציות המאומתים עדיין יכולים לגשת למסד הנתונים.

  3. בוחרים מיקום למסד הנתונים.

    בהתאם למיקום של מסד הנתונים, כתובת ה-URL של מסד הנתונים החדש תהיה באחד מהפורמטים הבאים:

    • DATABASE_NAME.firebaseio.com (למסדי נתונים ב-us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (למסדי נתונים בכל המיקומים האחרים)

  4. לוחצים על סיום.

כשמפעילים את Realtime Database, ה-API מופעל גם במנהל Cloud API.

בחירת ספריית עזר

אפשר לקרוא ולכתוב נתונים דרך ה-API ל-REST ישירות משורת הפקודה. במדריך הזה נשתמש ב-cURL בכל הדוגמאות. יש לנו גם כמה ספריות עזר של צד שלישי ליצירת אינטראקציה עם ה-API ל-REST מהשפה המועדפת עליכם. אפשר להשתמש באחת מספריות העזר הבאות או ליצור ספרייה משלכם:

שפה ספריות
Clojure taika מבית Cloudfuji
Dart IO Client בספרייה הרשמית firebase-dart
Go Firego מאת Steven Berlanga ו-Tim Gossett
Go Firebase מאת Cosmin Nicolaescu ו-Justin Tulloss
Java firebase4j מאת Brandon Gresham
Perl Firebase-Perl מאת Kiran Kumar ו-JT Smith
PHP firebase-php מ-kreait
firebase-php מ-Tamas Kalman
Python Pyrebase מאת James Childs-Maidment
python-firebase מאת Özgür Vatansever
python-firebase מאת Michael Huynh
Ruby firebase-ruby מאת Oscar Del Ben
BigBertha מאת Fernand Galiana
rest-firebase מאת Codementor

השלבים הבאים