שלום לכולם!
רבים מכם מכירים את המודול המובנה של "הוספת ערך לקובץ" (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 - "אנא הקישו את הערך הרצוי ובסיום הקישו סולמית"
בהצלחה לכולם! תהנו מהמודול המשודרג וספרו בתגובות איך עובד אצלכם!