Source: https://ailoot.ai/docs/he/cabinet/redeem/
Canonical: https://ailoot.ai/docs/he/cabinet/redeem/
Language: he

[API של האזור האישי](https://ailoot.ai/docs/he/) 

# קודים להוספת כסף ליתרה

[Markdown](https://ailoot.ai/docs/he/cabinet/redeem/index.md)

מתודות, שדות בקשה ותשובות.

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

| מתודה ונתיב | תיאור | גישה |
| --- | --- | --- |
| `POST /api/v1/redeem` | מימוש קוד | טוקן של האזור האישי |
| `GET /api/v1/redeem/history` | היסטוריית המימושים | טוקן של האזור האישי |

**POST /api/v1/redeem** — מימוש קוד

גישה: טוקן של האזור האישי

POST`/api/v1/redeem`

## שדות JSON / טופס

| השדה | טיפוס | חובה | בדיקה / תיאור |
| --- | --- | --- | --- |
| `code` | `string` | כן | required |

תבנית גוף הבקשה

```json
{
  "code": "PLACEHOLDER_CODE (string)"
}
```

PLACEHOLDER מציין את הקלט שלכם ואת הטיפוס שלו. החליפו את הערכים והשאירו רק את שדות הרשות הנדרשים; אין לשלוח סמני מחרוזת במקום מספרים, boolean, אובייקטים או מערכים.

סכמת הבקשה: `RedeemRequest`

## תשובה

תשובת JSON מכילה code, message ו-data. תוכן data מתואר בסכמות שלהלן.

סכמות הנתונים של התשובה: `RedeemCode`. השדות והטיפוסים מופיעים בעמודי "סכמות נתונים".

סכמת התשובה, הערכים להמחשה

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "id": "PLACEHOLDER_ID (integer)",
    "code": "PLACEHOLDER_CODE (string)",
    "type": "PLACEHOLDER_TYPE (string)",
    "value": "PLACEHOLDER_VALUE (number)",
    "status": "PLACEHOLDER_STATUS (string)",
    "used_by": "PLACEHOLDER_USED_BY (integer)",
    "used_at": "PLACEHOLDER_USED_AT (string)",
    "created_at": "PLACEHOLDER_CREATED_AT (string)",
    "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
    "validity_days": "PLACEHOLDER_VALIDITY_DAYS (integer)",
    "notes": "PLACEHOLDER_NOTES (string)",
    "user": "PLACEHOLDER_USER (object)"
  }
}
```

מאפיינים: כל הנתונים האישיים והאובייקטים מוגבלים לזהות ה-subject ב-JWT.

מאפיינים: הפעולה משנה מצב או ממשיכה תהליך אימות חד-פעמי; הדוגמה מתארת את החוזה ואינה מבוצעת.

המתודה משנה נתונים. שליחה חוזרת בטוחה רק במתודות שבהן מצוין Idempotency-Key. אם התשובה אבדה, בדקו תחילה את התוצאה (למשל את רשימת המפתחות), ורק אז החליטו אם לשלוח את הבקשה שוב.

**GET /api/v1/redeem/history** — היסטוריית המימושים

גישה: טוקן של האזור האישי

GET`/api/v1/redeem/history`

קריאה; המזהה נלקח מהתשובה הקודמת שקיבלתם

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/redeem/history" \
  -H "Authorization: Bearer $TOKEN"
```

## פרמטרי Query

| השדה | טיפוס | חובה | בדיקה / תיאור |
| --- | --- | --- | --- |
| `page` | `integer` | לא | ; ברירת המחדל: 1; positive integer |
| `page_size` | `integer` | לא | ; ברירת המחדל: 20; positive; clamp to100 |

אין צורך בגוף בקשה. העבירו את הפרמטרים המפורטים לעיל ב-URL.

## תשובה

תשובת JSON מכילה code, message ו-data. תוכן data מתואר בסכמות שלהלן.

סכמות הנתונים של התשובה: `RedeemCode`. השדות והטיפוסים מופיעים בעמודי "סכמות נתונים".

סכמת התשובה, הערכים להמחשה

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": "PLACEHOLDER_ID (integer)",
        "code": "PLACEHOLDER_CODE (string)",
        "type": "PLACEHOLDER_TYPE (string)",
        "value": "PLACEHOLDER_VALUE (number)",
        "status": "PLACEHOLDER_STATUS (string)",
        "used_by": "PLACEHOLDER_USED_BY (integer)",
        "used_at": "PLACEHOLDER_USED_AT (string)",
        "created_at": "PLACEHOLDER_CREATED_AT (string)",
        "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
        "validity_days": "PLACEHOLDER_VALIDITY_DAYS (integer)",
        "notes": "PLACEHOLDER_NOTES (string)",
        "user": "PLACEHOLDER_USER (object)"
      }
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}
```

מאפיינים: כל הנתונים האישיים והאובייקטים מוגבלים לזהות ה-subject ב-JWT.

נשארו שאלות? שלחו Request ID ותיאור — נעזור לברר.[פנייה לתמיכה](mailto:support@ailoot.ai)

## Ailoot · החברה ופורטפוליו הפרויקטים שלה





Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.





החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.





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