ספריות לקוח מאפשרות לכם לגשת Cloud de Confiance by S3NS ל-API באופן פרוגרמטי עם פחות קוד שחוזר על עצמו, כי הן מטפלות באימות ובקשר עם השרת ברמה נמוכה. במסמך הזה מוסברות השיטות הבאות לאינטראקציה עםCloud de Confiance ממשקי API:
- ספריות לקוח ב-Cloud (מומלץ)
- ספריות לקוח של Google API
- פלטפורמת הפיתוח של Firebase
- קוד לקוח משלכם
כדי למצוא מידע על ספריות לקוח למוצר ספציפי Cloud de Confiance , אפשר לעיין בקטע 'ספריות לקוח' במסמכי העזרה של המוצר.
ספריות לקוח ב-Cloud
אמנם אפשר להשתמש Cloud de Confiance by S3NS ישירות ב-APIs על ידי יצירת בקשות גולמיות חדשות לשרת, אבל ספריות הלקוח של Cloud מפשטות את התהליך ומפחיתות באופן משמעותי את כמות הקוד שתצטרכו לכתוב. ספריות הלקוח ב-Cloud הן האפשרות המומלצת לגישה ל-Cloud APIs באופן פרוגרמטי, כי הן משתמשות במודל העדכני של ספריות לקוח וכוללות את היתרונות הבאים:
- כדי ש Cloud de Confiance ממשקי ה-API יהיו אינטואיטיביים לשימוש, צריך לספק קוד אידיומטי בכל שפה.
- ספריות הלקוח צריכות להיות בעלות סגנון עקבי כדי לפשט את העבודה עם כמה Cloud de Confiance by S3NS שירותים.
- לטפל בכל הפרטים ברמה הנמוכה של התקשורת עם השרת, כולל אימות ב-Google.
- אפשר להתקין אותו באמצעות כלים מוכרים לניהול חבילות כמו
npmו-pip. - במקרים מסוימים, שימוש ב-gRPC יכול לשפר את הביצועים. מידע נוסף זמין במאמר בנושא gRPC APIs.
הוראות ההתקנה וחומרי העזר של ספריות הלקוח ב-Cloud משתנים בהתאם ל-API Cloud de Confiance הספציפי ולשפת התכנות שבה אתם משתמשים. כדי למצוא את המידע הזה, אפשר לעיין במסמכי העזרה של Cloud de Confiance המוצר הספציפי. ברוב המוצרים יש קטע Client Libraries (ספריות לקוח) במסמכי התיעוד שלהם, שכולל הנחיות ספציפיות לשפה, שלבי התקנה וקישורים להפניה מפורטת ל-API.
כדי למצוא את מאמרי העזרה של מוצר ספציפי, אפשר לעיין Cloud de Confiance by S3NS בספריית ה-API.
ספריות לקוח של Google API
אם ספריות הלקוח ב-Cloud לא זמינות בשפה המועדפת שלכם עבור API ספציפי, אתם יכולים להשתמש בספריות הלקוח של Google API. אלה ספריות לקוח מוקדמות יותר שסופקו על ידי Google.
יכול להיות שתשתמשו בספריות האלה גם אם אתם משדרגים פרויקט שכבר נעשה בו שימוש בספריות האלה. הספריות האלה:
- הגישה היא רק לממשק REST של ה-API, אין תמיכה ב-gRPC.
- יש קוד ממשק שנוצר אוטומטית, שאולי לא אידיומטי כמו ספריות הלקוח ב-Cloud.
- לטפל בכל הפרטים ברמה הנמוכה של התקשורת עם השרת, כולל אימות ב-Google.
- אפשר להתקין אותו באמצעות כלים מוכרים לניהול חבילות כמו
npmו-pip.
שימוש בפלטפורמת הפיתוח של Firebase
Firebase היא פלטפורמת השירותים של Google שנועדה לתמוך בכל מחזור החיים של פיתוח האפליקציה. היא מספקת ערכות SDK חוצות-פלטפורמות שיעזרו לכם ולסוכני AI ליצור ולהפעיל אפליקציות לפלטפורמות של אפל, ל-Android, לאינטרנט, ל-Flutter, ל-Unity ול-C++.
מידע על ממשקי ה-API Cloud de Confiance הנתמכים ועל תחילת השימוש ב-Firebase זמין ב מסמכי התיעוד של Firebase.
שימוש בקוד לקוח משלכם
אם אתם מפתחים מנוסים וספריות הלקוח של Cloud לא עונות על הצרכים הספציפיים שלכם, אתם יכולים לכתוב קוד מותאם אישית משלכם כדי לגשת ישירות לממשקי ה-API של השירות ברמה נמוכה יותר.
ממשקי API של REST/HTTP
כל ממשקי ה-API Cloud de Confiance חושפים ממשק JSON/REST. אם אתם צריכים לכתוב קוד מותאם אישית משלכם כדי לגשת ישירות ל-API בארכיטקטורת REST באמצעות ספריית לקוח HTTP של צד שלישי, תוכלו לקרוא מידע נוסף על אופן הפעולה של Cloud de Confiance ממשקי API עם גרסאות והטמעות שונות של HTTP ב הנחיות ל-HTTP.
ממשקי gRPC API
gRPC היא מערכת קוד פתוח לקריאה לשירות מרוחק (RPC) שאינה תלויה בשפה או בפלטפורמה, ופותחה במקור ב-Google. מידע נוסף זמין באתר grpc.io. לממשקי API Cloud de Confiance עם gRPC יש בדרך כלל ממשקי REST ו-RPC, כך שבמקום להשתמש רק ב-JSON over HTTP כדי לתקשר עם ממשק ה-REST, לקוחות API עם gRPC יכולים גם להשתמש ב-protocol buffers וב-gRPC over HTTP2 כדי לתקשר עם ממשק ה-RPC. כדי לדעת אם API תומך ב-gRPC, צריך לבדוק את הקטע 'ממשקי API והפניות'.
אם Cloud de Confiance API מופעל באמצעות gRPC, אפשר ליצור ספריות לקוח משלכם ל-gRPC בשפה כלשהי שנתמכת על ידי gRPC. כדי לעשות את זה, תצטרכו את הגדרת השירות של מאגרי הפרוטוקולים של ה-API (בדרך כלל אפשר למצוא אותה במאגר ב-GitHub).
אחר כך אפשר לפעול לפי ההוראות בשפה המועדפת בכתובת grpc.io כדי ליצור את הלקוח ולהשתמש בו.
אם אתם לא רוצים ליצור קוד gRPC משלכם, אתם עדיין יכולים ליהנות מ-gRPC: מספר גדל והולך של ספריות לקוח של Cloud ל-APIs עם תמיכה ב-gRPC משתמשות ב-gRPC 'מאחורי הקלעים' כדי לתקשר עם השרתים של Google. הגישה ל-API באמצעות gRPC יעילה הרבה יותר מבחינת קצב העברת הנתונים ושימוש במעבד (CPU). קצב העברת הנתונים לכל מעבד יכול להיות גבוה פי 10 בהשוואה ל-API בפורמט JSON בארכיטקטורת REST. Google מתכננת לשדרג כמה שיותר ספריות לקוח של Cloud ל-gRPC. בינתיים, תוכלו ליהנות מכל היתרונות האחרים של קוד ספריית הלקוח של Google.
דרכים נוספות לגשת אל Cloud APIs
אם אתם לא רוצים לגשת ל-API באופן פרוגרמטי, אתם יכולים לגשת לחלק מהפונקציות האלה באמצעות הכלים ב-Google Cloud CLI או באמצעות Cloud de Confiance המסוף.