התקנה & הגדרה של 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, לנהל את האימות, הפריסות ונתוני ה-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, מערכת ה-API מופעלת גם בCloud API Manager.

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

אפשר לקרוא ולכתוב נתונים דרך ה-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

השלבים הבאים