שלום לכולם! 
רבים מכם מכירים את המודול המובנה של "הוספת ערך לקובץ" (add_id_to_list). פיתחתי עבורכם גרסה משודרגת ב-API, שלוקחת את היכולות של המודול המובנה כמה צעדים קדימה ומביאה חידושים בלעדיים!
מה החידושים בגרסה המשודרגת?
- שילוב מושלם בהשמעת קבצים (
file_phone) : ניתן להגדיר שהמפתח או הערך יהיו מספר הטלפון של מקליט ההודעה שמושמעת באותו רגע!
- הוספת סיומת קבועה (
key_last / value_last) : מלבד הוספת טקסט לפני המפתח/הערך (first), ניתן כעת להוסיף טקסט קבוע גם אחריהם.
- גמישות מלאה בסיומות קבצים: ניתן לערוך כל קובץ במערכת (כולל
.ini, .txt או כל סיומת אחרת), שכן שם הקובץ מוגדר באופן מלא כולל הסיומת.
- שמות פרמטרים קצרים ונוחים: ללא הקידומת הארוכה
add_id_to_list_.
️ שלב 1: חיבור המודול והגדרת קובץ היעד
את המודול ניתן להגדיר כשלוחה עצמאית (type=api) או להטמיע אותו בתוך שלוחת השמעת קבצים (באמצעות control_playX / after_play).
הגדרות החיבור הבסיסיות:
type=api
api_link=https://moduls.smartel.workers.dev/add_id_to_list.php
api_add_0=token=הטוקן_שלכם
קביעת מיקום ושם הקובץ לעריכה (location_list) :
חובה להגדיר את הנתיב המלא של הקובץ כולל סיומת הקובץ (לדוגמה: id.ini/) :
api_add_1=location_list=/id.ini
אפשרות לבחירת השלוחה על ידי המאזין:
אם תרצו שהמאזין יקיש את מספר השלוחה שבה נמצא הקובץ (המערכת תבקש הקשת שלוחה):
api_add_1=location_list=TFR
api_add_2=location_tfr_file_name=ext.ini
שלב 2: הגדרת ה-Key (המפתח)
המפתח הוא החלק שמופיע לפני סימן השווה.
בחירת סוג המפתח (key_type או key) :
api_add_X=key=מפתח
- מספר הטלפון/הזיהוי של המאזין הנכנס:
api_add_X=key_type=EnterID
(שימו לב: בשונה מהמודול המובנה, בגרסה זו חובה להגדיר במפורש EnterID אם רוצים את זיהוי המאזין).
- הקשת ספרות על ידי המאזין:
api_add_X=key_type=digits
(משמיע הודעה להקשת המפתח).
- הקלדה במקלדת (אותיות/ספרות):
api_add_X=key_type=keyboard
חדש! מספר הטלפון של מקליט ההודעה:
api_add_X=key_type=file_phone
(פעיל בהשמעת קבצים - שולף אוטומטית את מספר הטלפון של מי שהקליט את הקובץ הנוכחי).
הוספת קידומת וסיומת קבועה למפתח:
api_add_X=key_first=SIP-
(תוצאה: SIP-Key)
חדש! סיומת אחרי המפתח:
api_add_X=key_last=-OK
(תוצאה: Key-OK)
שלב 3: הגדרת ה-Value (הערך)
הערך הוא החלק שמופיע לאחר סימן השווה.
בחירת סוג הערך (value_type או value) :
api_add_X=value=ערך
- מספר הטלפון/הזיהוי של המאזין הנכנס:
api_add_X=value_type=EnterID
- הקשת ספרות על ידי המאזין:
api_add_X=value_type=digits
api_add_X=value_type=keyboard
חדש! מספר הטלפון של מקליט ההודעה:
api_add_X=value_type=file_phone
הוספת קידומת וסיומת קבועה לערך:
api_add_X=value_first=t-
(תוצאה: Key=t-Value)
חדש! סיומת אחרי הערך:
api_add_X=value_last=-end
(תוצאה: Key=Value-end)
שלב 4: עדכון, שינוי ופעולות חשבון על ערכים קיימים
כברירת מחדל, המודול מוסיף שורה חדשה. אם המפתח כבר קיים בקובץ, המערכת תציג שגיאה.
שינוי ערך קיים (value_change) :
כדי לעדכן ערך של מפתח שכבר קיים בקובץ (למשל להחליף מ-0501234567=old ל-0501234567=new), הוסיפו:
api_add_X=value_change=yes
פעולות חשבון על ערכים מספריים (מונעים / מוני לייקים וכדומה):
אם הערך בקובץ הוא מספרי (למשל id=1), תוכלו להגדיר שהמערכת תעלה או תוריד את המספר ב-1:
- הוספת 1 לערך הקיים:
api_add_X=value_plus=yes (מ-id=1 יהפוך ל-id=2)
- הורדת 1 מהערך הקיים:
api_add_X=value_minus=yes (מ-id=2 יהפוך ל-id=1)
(הערה: הגדרת מינוס גוברת על פלוס).
שלב 5: הגדרת ערך עם תוקף זמן (תפוגה אוטומטית)
תוכלו לקבוע שהערך שנוסף יישאר בתוקף לזמן מוגדר בלבד.
(שימו לב: תוקף זמן עובד כאשר מוגדרים גם מפתח וגם ערך).
הגדרת משך התוקף (value_expired) :
api_add_X=value_expired=4h
טבלת פורמטים לבחירת זמן תפוגה:
| ערך זמן |
תיאור |
דוגמה |
s |
שניות |
30s |
m |
דקות (אות קטנה) |
15m |
h |
שעות |
4h |
d |
ימים |
2d |
M |
חודשים (אות גדולה!) |
1M |
YYYY-MM-DD |
עד סוף תאריך מסוים |
2026-12-31 |
YYYY-MM-DD HH:MM:SS |
עד תאריך ושעה מדויקים |
2026-12-31 23:59:59 |
HH:MM:SS |
עד שעה מסוימת היום |
18:00:00 |
none |
ללא פקיעת תוקף (קבוע) |
none |
שינוי ערך אוטומטי לאחר פקיעת התוקף:
כברירת מחדל, הערך נמחק כשתוקפו פג. אם תרצו שיוחלף בערך אחר (למשל menu), הגדירו:
api_add_X=value_expired_change_to=menu
שלב 6: בדיקה בקובץ נוסף וניתוב בסיום
בדיקה בקובץ נוסף:
ניתן להגדיר שהמערכת תבדוק קודם אם המפתח קיים בקובץ נוסף. אם הוא קיים שם – המערכת תציג שגיאה ולא תרשום:
api_add_X=check_block_list=yes
api_add_X=location_list_block=/WhiteList.ini
קביעת לאן לעבור בסיום התהליך:
api_add_X=end_goto=/1
- לאן לעבור במקרה של שגיאה (למשל אם כבר רשום):
api_add_X=error_end_goto=/2
הודעות מערכת רלוונטיות למודול:
M4350 - "אנא הקישו את השלוחה ממנה תרצו לקחת את הקובץ..."
M4359 - "הנכם מועברים לכתיבת מפתח"
M4360 - "הנכם מועברים לכתיבת ערך"
M3410 - "מספרכם אינו רשאי להירשם, לבירורים פנו לאחראי"
M3411 - "הרישום בוצע בהצלחה, שלום ותודה"
M3949 - "אנא הקישו את המפתח הרצוי ובסיום הקישו סולמית"
M4358 - "אנא הקישו את הערך הרצוי ובסיום הקישו סולמית"
בהצלחה לכולם! תהנו מהמודול המשודרג וספרו בתגובות איך עובד אצלכם!