איך בונים מתזמן פוסטים לרשתות חברתיות על API: התור, המדיה וסטטוסי הפוסטים
כדי לבנות מתזמן פוסטים על ה-Partner API של easyCoexistence, השרת שלכם שולח כל פוסט אל POST /channels/:id/posts עם הטקסט, המדיה והשדה publish_at, שנע בין דקה אחת לבין 90 ימים קדימה. easyCoexistence מעתיקה את המדיה מיד ומפרסמת את הפוסט במועדו ב-Instagram, ב-Facebook, ב-TikTok או ב-LinkedIn, ומדווחת על כל שלב כסטטוס ובאירועים post.published ו-post.failed.
עד כמה מראש ה-posts API מתזמן פוסטים ב-Instagram, ב-Facebook, ב-TikTok וב-LinkedIn; המועד המוקדם ביותר הוא דקה אחת מעכשיו.
התמונה הגדולה והסרטון הגדול ש-easyCoexistence מעתיקה בעת תזמון פוסט; קובץ גדול יותר נדחה באותו רגע.
מתי פוסט שהרשת הגבילה את קצב השליחה שלו מנסים שוב, לפני שהוא מסומן ככושל.
מספר הפוסטים שחשבון Instagram יכול לפרסם בחלון נע של 24 שעות; קרוסלה נספרת כפוסט אחד.
המכסה של TikTok לפוסטי וידאו לכל חשבון דרך נקודת הקצה לפרסום שלו, עד שישה בדקה.
מה מתזמן צריך מה-API?
חמישה דברים: מקום להעלאת קבצים, קריאה שמכניסה פוסט לתור של חשבון אחד, תור שמפרסם בזמן, דרך לשנות החלטה, ודיווח על מה שקרה. ה-posts API מספק כל אחד מהם באותו מפתח ec_live_ שמחבר את הלקוחות שלכם, כך שהיומן, זרימת האישור והעורך נשארים במוצר שלכם.
איך מתזמנים פוסט?
בקריאת POST אחת לכל חשבון אל https://easycoexistence.com/api/v1/channels/:id/posts, כאשר :id הוא ה-channel_id מסשן החיבור של הלקוח. publish_at הוא בתבנית ISO 8601 עם Z או עם היסט; אם משמיטים אותו, הפוסט מתפרסם מיד. התשובה היא 201 עם הפוסט, או 422 כששלחתם פוסט למועד מיידי שנכשל. כותרת Idempotency-Key נתמכת, כך שבקשה שחוזרת לאחר פסק זמן לא תכניס את הפוסט לתור פעמיים. הגוף כולל:
- text: הכיתוב, ההודעה או הטקסט המלווה; media: רשימה של {"url", "type"} או {"
media_id"}. - link: פוסט קישור ב-Facebook או מאמר ב-LinkedIn, עם כותרת ב-LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS או STORIES, נגזר מהמדיה כשמשמיטים אותו.- title ו-
disable_commentלפוסטי תמונה ב-TikTok;image_altלתמונה ב-LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'איך המתזמן מטפל במדיה?
בקישור או בהעלאה. קישור HTTPS ציבורי נכנס ישירות לשדה media; קובץ שהמשתמשים מעלים נשלח אל POST /media, כגוף הבקשה עם הכותרות Content-Type ו-Content-Length, או כ-{"url"}, וה-media_id שהיא מחזירה נכנס לפוסט. כשפוסט מתוזמן, easyCoexistence מעתיקה את הקבצים שלו, ולכן הקישור שלכם צריך לעבוד רק באותו רגע. דף אינטרנט במקום קובץ, קוד 404, סוג שגוי, או קובץ מעל 30 MB לתמונות או 1 GB לסרטונים נדחה אז, ולא בבוקר הפרסום.
מה מכיל פוסט בכל רשת?
התור בודק כל פוסט מול הכללים של הרשת לפני שהוא מקבל אותו, ופוסט שמפר אחד מהם נדחה עם הודעה שמציינת את הכלל. כך העורך שלכם יכול להציג את הבעיה בזמן שהמשתמש עדיין עורך. כל רשת מקבלת:
באילו סטטוסים עובר פוסט?
שישה. הם מוחזרים בקריאות GET /posts/:id ו-GET /posts, יחד עם publish_at, הקישור של הפוסט אחרי שפורסם, והשגיאה שהרשת החזירה כשהפוסט נכשל:
- scheduled: בתור, ממתין לשעתו.
- publishing: הועבר לרשת.
- processing: הרשת עדיין עובדת עליו, כמו בסרטון TikTok או ב-container של Instagram.
- published: חי, עם הקישור שלו.
- failed: נדחה או לא אושר;
may_be_publishedמסמן פוסט שהרשת עשויה לקבל. - canceled: בוטל לפני שיצא, על ידכם, או משום שהערוץ שלו הוסר או הושעה.
איך עורכים, מבטלים או מנסים שוב פוסט?
PATCH /posts/:id משנה את המועד או הטקסט של פוסט מתוזמן, וכותרת של פוסט תמונה ב-TikTok; כדי לשנות את המדיה, מבטלים אותו ומתזמנים חדש. DELETE /posts/:id מבטל אותו. POST /posts/:id/retry מפרסם מחדש פוסט שנכשל, עכשיו. פוסט שהרשת הגבילה את קצבו מנוסה שוב באופן אוטומטי אחרי 5 דקות, 30 דקות ו-2 שעות, ופוסט שמסומן may_be_published דורש בדיקה של החשבון לפני כל ניסיון חוזר.
איך המתזמן שומע מה קרה?
מאירועים ומהרשימה. כתובת אירועי הסטטוס שמוגדרת תחת "Profile", "Developers" מקבלת את post.published ואת post.failed, חתומים ב-X-EC-Signature כמו כל אירוע אחר, עם הפוסט והערוץ שלו, כך שהיומן שלכם יכול לסמן כל פוסט כחי או להתריע עליו. GET /posts מקבל status, from, to ו-limit לתצוגות יומן, ו-GET /channels/:id/posts מציג חשבון אחד. פוסט שנכשל ברקע שולח גם אימייל לבעלים של חשבונכם, לכל היותר פעם אחת לכל ערוץ כל 3 שעות.
איך פוסטים של LinkedIn משתלבים במתזמן?
עם אדם שמאשר כל פוסט. תנאי ה-API Terms של LinkedIn מגבילים שימוש ב-APIs שלה לאוטומציה של פרסום, ולכן מתזמן שומר כל פוסט ב-LinkedIn כטיוטה במוצר שלכם עד שאדם בשמו מאשר אותו, ואז שולח אותו עם publish_at שלו. כללים חוזרים, פידים וייבואים המוניים צריכים להיות מופנים לרשתות האחרות, ו-LinkedIn צריך להישאר לפוסטים שמישהו בדק.
טעויות נפוצות
- שליחת publish_at בלי היסט. שעון מקומי בלי Z או היסט נדחה, לכן שלחו 2026-11-20T09:00:00-05:00 ולא את השעה הבודדת שהמשתמש בחר.
- ניסיון חוזר מיידי לפוסט שמסומן may_be_published. הרשת עשויה כבר להציג אותו, לכן בדקו את החשבון קודם, אחרת הפוסט יפורסם פעמיים.
- חזרה על POST שחרג מזמן ההמתנה בלי Idempotency-Key. תנו לכל פוסט מפתח משלו, כך שבקשה חוזרת מחזירה את הפוסט שכבר בתור במקום לתזמן עותק שני.
- קישור לקבצי PNG לאינסטגרם. ה-publishing API של Instagram מקבל JPEG בלבד, והפוסט נדחה בזמן התזמון, לכן המירו תמונות בשלב ההעלאה שלכם.
easyCoexistence נותנת למתזמן שלכם תור אחד לחשבונות Instagram, Facebook, TikTok ו-LinkedIn של הלקוחות שלכם, ועוד ערוצים, דרך ה-API הרשמי של כל רשת: מדיה שמועתקת בזמן התזמון, שישה סטטוסים, ניסיונות חוזרים למגבלות קצב ואירועי פוסטים חתומים, עם ניטור של כל חיבור 24/7. US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
אפשר לתזמן פוסט אחד על כמה רשתות בבקשה אחת?
כל בקשה מכוונת לערוץ אחד, לכן שלחו בקשה אחת לכל חשבון, כל אחת עם Idempotency-Key משלה, והתאימו את הטקסט למגבלות של כל רשת.
האם ה-posts API מתזמן סרטוני YouTube?
YouTube מתזמן באופן מקורי. העלו את הסרטון דרך ה-API של YouTube כפרטי עם publishAt, באמצעות האסימון שמוחזר בקריאה GET /channels/:id?credentials=1, ו-YouTube הופך אותו לציבורי באותו מועד.
האם המשתמשים שלי יכולים לראות את הפוסטים המתוזמנים שלהם בלוח הבקרה של easyCoexistence?
מסך Posts שייך לחשבון שלכם, כך שהצוות שלכם רואה שם את "Needs attention", "Coming up" ו-"Published", עם "Cancel", "Retry" ו-"Dismiss". המשתמשים שלכם רואים את היומן שהמוצר שלכם בונה על בסיס GET /posts.
כמה עולה easyCoexistence למתזמן רשתות חברתיות?
US$ 9 עד US$ 0.75 לחשבון מחובר בחודש, יורד ככל שהמשתמשים שלכם מחברים יותר חשבונות, כולל התזמון ועם תקופת ניסיון של 3 ימים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-