---
title: "הבקשה הראשונה והסנדבוקס"
description: "תנסו את ה-API בלי מפתח בסנדבוקס, ואז תשלחו בקשה אמיתית עם המפתח שלכם."
canonical: https://app.ueventi.com/docs/he/articles/your-first-request-and-the-sandbox
last_updated: 2026-10-14
language: he
collection: "API ואינטגרציות"
---

# הבקשה הראשונה והסנדבוקס

תנסו את ה-API בלי מפתח בסנדבוקס, ואז תשלחו בקשה אמיתית עם המפתח שלכם.

כל הנושאים: [API ואינטגרציות](https://app.ueventi.com/docs/he/api-and-integrations)

ה-API נמצא בכתובת **https://api.ueventi.com**. כל בקשה היא קריאת HTTPS רגילה שמחזירה JSON, אז זה עובד מכל שפת תכנות, מכלים כמו Zapier או Make ומסוכני AI.

## מתחילים בסנדבוקס

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

- **GET https://api.ueventi.com/v1/sandbox/events** - מחזיר את אירועי הדוגמה.
- **GET https://api.ueventi.com/v1/sandbox/events/evt_sandbox_wedding/guests** - מחזיר את אורחי החתונה עם סטטוס אישור ההגעה שלהם.
- **GET https://api.ueventi.com/v1/sandbox/events/evt_sandbox_wedding/rsvps** - סיכום אישורי ההגעה בקריאה אחת.

## הבקשה האמיתית הראשונה

תשלחו את המפתח בכותרת Authorization כ-bearer token. למשל, עם curl: **curl -H "Authorization: Bearer ev_live_..." https://api.ueventi.com/v1/events**. תקבלו בחזרה את האירועים של סביבת העבודה שלכם, כל אחד עם מספר האורחים שלו.

רשימות מגיעות בעמודים. כשבתשובה יש **next_cursor**, תחזירו אותו כ-**?cursor=** כדי לקבל את העמוד הבא. כשהוא **null**, קיבלתם הכול.

## מגבלות ושגיאות

כל מפתח יכול לשלוח 60 בקשות בדקה (הסנדבוקס: 30 לכל כתובת). כל תשובה אומרת כמה נשאר בכותרת **RateLimit-Remaining**. אם עברתם את המגבלה, תקבלו **429** עם כותרת **Retry-After** שאומרת כמה שניות לחכות.

שגיאות תמיד חוזרות כ-JSON עם קוד **error**, הודעת **message** ושדה **how_to_fix** שאומר מה לעשות עכשיו. **401** אומר שהמפתח חסר או בוטל, **403** אומר שחסרה לו הרשאה, **404** אומר שהאירוע לא נמצא בסביבת העבודה שלכם.

> **Note:** התיעוד המלא עם כל השדות נמצא ב-[ueventi.com/developers](https://ueventi.com/developers), והמפרט שמיועד למכונות ב-[api.ueventi.com/openapi.json](https://api.ueventi.com/openapi.json).

## מאמרים קשורים

- [יצירת מפתח API](https://app.ueventi.com/docs/he/articles/create-an-api-key.md): תיצרו מפתח לסקריפט או לסוכן AI, תבחרו מה מותר לו לעשות ותשמרו עליו.
- [הוספת אורחים בכמויות דרך ה-API](https://app.ueventi.com/docs/he/articles/add-guests-in-bulk-with-the-api.md): תדחפו אורחים מגיליון או מ-CRM, עד 100 בכל קריאה, עם תוצאה לכל אחד.
- [ייצוא אישורי הגעה דרך ה-API](https://app.ueventi.com/docs/he/articles/export-rsvps-with-the-api.md): תורידו את רשימת האורחים עם התשובות כקובץ CSV, מוכן למפיקה או לגיליון.