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

‫Firebase Realtime Database הוא מסד נתונים שמתארח בענן. הנתונים מאוחסנים בפורמט JSON ומסונכרנים בזמן אמת עם כל לקוח מחובר. כשאתם בונים אפליקציות חוצות פלטפורמות באמצעות ערכות ה-SDK שלנו ל-Android, לפלטפורמות של אפל ול-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, לנהל את האימות, הפריסות ונתוני ה-Analytics של האפליקציה.

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

  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, מערכת Cloud API Manager מפעילה גם את ה-API.

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

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

שפה ספריות
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 by kreait
firebase-php by 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

השלבים הבאים