🤣 בדיחות של רן

API Documentation

תיעוד ה-API של האתר

בדף זה מסביר את שני ה-endpoints שמחזירים בדיחות מהאתר: getDailyJoke ו-getRandomJoke. שניהם מחזירים תגובה בפורמט JSON ומתאימים לשימוש עם כלים כמו curl, Postman או מפתחים שרוצים להטמיע את הנתונים באפליקציה.

GET /api/getDailyJoke.php

Daily Joke

endpoint זה מחזיר את בדיחת היום שנבחרה על ידי המערכת. הוא מתאים לשימוש כאשר רוצים להציג בדיחה קבועה ביום מסוים.

  • שיטה: GET
  • דרישה: אין פרמטרים
  • תשובה מוצלחת: 200 OK עם JSON
  • שגיאות נפוצות: 404 אם אין בדיחות זמינות, 405 אם נשלחת שיטה אחרת

דוגמת curl:

curl "/api/getDailyJoke.php"

דוגמת תגובה:

{
  "success": true,
  "joke": {
    "id": 123,
    "title": "בדיחה של היום",
    "content": "תוכן הבדיחה",
    "category": "general",
    "author": "שם הכותב",
    "date_created": "...",
    "likes": 0,
    "average_rating": 0,
    "times_daily_count": 1
  }
}

GET /api/getRandomJoke.php

Random Joke

endpoint זה מחזיר בדיחה אקראית מהמאגר. הוא שימושי כאשר רוצים להציג בדיחה שונה בכל טעינה או בכל בקשה.

  • שיטה: GET
  • דרישה: אין פרמטרים
  • תשובה מוצלחת: 200 OK עם JSON
  • שגיאות נפוצות: 404 אם אין בדיחות זמינות, 405 אם נשלחת שיטה אחרת

דוגמת curl:

curl "/api/getRandomJoke.php"

דוגמת תגובה:

{
  "success": true,
  "joke": {
    "id": 456,
    "title": "בדיחה אקראית",
    "content": "תוכן הבדיחה",
    "category": "dark",
    "author": "שם הכותב",
    "date_created": "...",
    "likes": 2,
    "average_rating": 4.5
  }
}
אנחנו אוהבים בדיחות 😂 כל הזכויות שמורות לרן