Miten rakennat sosiaalisen median ajastustyökalun rajapinnalla: jono, media ja julkaisun tilat
Rakentaaksesi sosiaalisen median ajastimen easyCoexistencen Partner API:n avulla, backend lähettää jokaisen julkaisun POST /channels/:id/posts -pyyntönä tekstin, median ja publish_at-ajan, joka on 1 minuutista 90 päivään eteenpäin. easyCoexistence kopioi median heti ja julkaisee julkaisun sen ajassa Instagramiin, Facebookiin, TikTokiin tai LinkedIniin, ja raportoi jokaisen vaiheen tilana sekä tapahtumina post.published ja post.failed.
Kuinka pitkälle eteenpäin julkaisurajapinta ajastaa Instagramissa, Facebookissa, TikTokissa ja LinkedInissä; aikaisin hetki on 1 minuutin päässä.
Suurin kuva ja suurin video, jotka easyCoexistence kopioi julkaisua ajastettaessa; suurempi tiedosto hylätään siinä hetkessä.
Kun verkko on rajoittanut julkaisun nopeutta, julkaisua yritetään uudelleen ennen kuin se merkitään epäonnistuneeksi.
API:n kautta julkaistut julkaisut, joita Instagram-tili voi tehdä liukuvan 24 tunnin aikana; karuselli lasketaan yhdeksi.
TikTokin raja videojulkaisuille tiliä kohden sen julkaisupäätepisteen kautta, enintään kuusi minuutissa.
Mitä ajastin tarvitsee rajapinnalta?
Viisi asiaa: paikka tiedostojen lataamiseen, kutsu, joka jonottaa julkaisun yhdelle tilille, jono, joka julkaisee ajallaan, tapa muuttaa suunnitelmaa ja tieto siitä, mitä tapahtui. Julkaisurajapinta antaa jokaisen samalla ec_live_-avaimella, jolla yhdistät asiakkaasi, joten kalenteri, hyväksyntäprosessi ja kirjoitin pysyvät omassa tuotteessasi.
Miten julkaisu ajastetaan?
Yhdellä POST-pyynnöllä tiliä kohden osoitteeseen https://easycoexistence.com/api/v1/channels/:id/posts, missä :id on asiakkaan yhteysistunnon channel_id. publish_at on ISO 8601 -muodossa Z:llä tai aikaerolla; jätä pois, jos haluat julkaista heti. Vastaus on 201 julkaisun kanssa tai 422, jos heti tarkoitettu julkaisu epäonnistui. Idempotency-Key-otsaketta kunnioitetaan, joten aikakatkaisun jälkeen toistettu pyyntö ei jonota julkaisua kahdesti. Runko sisältää:
- text: kuvateksti, viesti tai kommentti; media: lista muodossa {"url", type} tai {"
media_id"}. - link: Facebook-linkkijulkaisu tai LinkedIn-artikkeli, LinkedInissä otsikolla.
ig_type: IMAGE, CAROUSEL, REELS tai STORIES, päätellään medista, jos jätetään pois.- title ja
disable_commentTikTok-kuvajulkaisuille;image_altLinkedIn-kuvalle.
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"
}'Miten ajastin käsittelee mediaa?
Joko linkillä tai lataamalla. Julkinen HTTPS-linkki menee suoraan media-kenttään; käyttäjiesi lataama tiedosto menee POST /media-pyynnön runkona, mukana Content-Type- ja Content-Length-otsakkeet, tai muodossa {"url"}, ja sen palauttama media_id liitetään julkaisuun. Kun julkaisu ajastetaan, easyCoexistence kopioi tiedostot, joten linkkisi täytyy toimia vain sillä hetkellä. Verkkosivu tiedoston sijaan, 404, väärä tyyppi tai kuva yli 30 MB tai video yli 1 GB hylätään silloin, ei julkaisun aamuna.
Mitä kunkin verkon julkaisu voi sisältää?
Jono tarkistaa jokaisen julkaisun verkon säännöt ennen sen hyväksymistä, ja sääntöjä rikkova julkaisu hylätään viestillä, joka nimeää säännön. Näin kirjoittimesi voi näyttää ongelman, kun käyttäjä vielä muokkaa. Jokainen verkko ottaa:
Minkä tilojen läpi julkaisu kulkee?
Kuusi. GET /posts/:id ja GET /posts raportoivat ne publish_at-ajan, julkaisun linkin, kun se on näkyvissä, ja verkon virheen, kun julkaisu epäonnistui:
- scheduled: jonossa, odottaa aikaansa.
- publishing: luovutettu verkolle.
- processing: verkko käsittelee sitä yhä, kuten TikTok-videon tai Instagram-containerin kanssa.
- published: julkaistu, linkki mukana.
- failed: hylätty tai vahvistamatta;
may_be_publishedmerkitsee julkaisun, jonka verkko on saattanut vastaanottaa. - canceled: poistettu ennen lähtöä, joko sinun toimestasi tai siksi, että sen kanava poistettiin tai keskeytettiin.
Miten julkaisua muokataan, perutaan tai yritetään uudelleen?
PATCH /posts/:id muuttaa ajastetun julkaisun aikaa tai tekstiä ja TikTok-kuvajulkaisun otsikkoa; median vaihtamiseksi peru julkaisu ja ajasta uusi. DELETE /posts/:id peruu sen. POST /posts/:id/retry julkaisee epäonnistuneen julkaisun uudelleen heti. Julkaisu, jonka verkko on rajoittanut, yritetään automaattisesti uudelleen 5 minuutin, 30 minuutin ja 2 tunnin kuluttua, ja julkaisu, joka on merkitty may_be_published, vaatii tilin tarkistuksen ennen mitään uutta yritystä.
Miten ajastin kuulee, mitä tapahtui?
Tapahtumien ja listan kautta. Osoite, joka on asetettu kohdassa Profile, Developers, vastaanottaa post.published- ja post.failed-tapahtumat, allekirjoitettuna X-EC-Signature-otsakkeella kuten kaikki muutkin tapahtumat, julkaisun ja sen kanavan kanssa, joten kalenterisi voi merkitä jokaisen julkaistuksi tai nostaa sen esiin. GET /posts ottaa parametrit status, from, to ja limit kalenterinäkymiin, ja GET /channels/:id/posts listaa yhden tilin. Julkaisu, joka epäonnistuu taustalla, lähettää myös sähköpostin tilisi omistajalle, enintään kerran kanavaa kohden 3 tunnin välein.
Miten LinkedIn-julkaisut sopivat ajastimeen?
Henkilön hyväksynnällä. LinkedInin API-ehdot rajoittavat sen rajapintojen käyttöä julkaisun automatisointiin, joten ajastin pitää jokaisen LinkedIn-julkaisun luonnoksena tuotteessasi, kunnes nimetty henkilö hyväksyy sen, ja lähettää sen sitten publish_at-ajalla. Toistuvat säännöt, syötteet ja massatuonnit kannattaa kohdistaa muihin verkkoihin, ja jätä LinkedIn niille julkaisuille, joita joku on tarkistanut.
Yleiset virheet
- Lähetät publish_at-kentän ilman aikaeroa. Paikallinen aika ilman Z:aa tai aikaeroa hylätään, joten lähetä 2026-11-20T09:00:00-05:00 sen sijaan, että lähettäisit käyttäjän valitseman kellonajan sellaisenaan.
- Yrität julkaisua uudelleen heti, vaikka se on merkitty may_be_published-tilaan. Verkko saattaa näyttää sen jo, joten tarkista tili ensin, tai julkaisu menee ulos kahdesti.
- Aikakatkaistun POST-pyynnön toistaminen ilman Idempotency-Key-otsaketta. Anna jokaiselle julkaisulle oma avain, jotta toistettu pyyntö palauttaa jo jonotetun julkaisun eikä ajasta toista kopiota.
- PNG-tiedostojen linkittäminen Instagramiin. Instagramin julkaisurajapinta hyväksyy vain JPEG-tiedostot, ja julkaisu hylätään ajastettaessa, joten muunna kuvat latausvaiheessa.
easyCoexistence antaa ajastimellesi yhden jonon asiakkaittesi Instagram-, Facebook-, TikTok- ja LinkedIn-tileille sekä muille kanaville, jokaisen verkon virallisen rajapinnan kautta: media kopioidaan julkaisua ajastettaessa, tiloja on kuusi, uudelleenyritykset nopeusrajoille ja allekirjoitetut julkaisutapahtumat, ja jokainen yhteys valvotaan 24/7. Hinta laskee US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa, kun lisäät yhteyksiä, ja ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Voiko yksi pyyntö ajastaa julkaisun useisiin verkkoihin?
Jokainen pyyntö kohdistuu yhteen kanavaan, joten lähetä yksi tiliä kohden, jokaisella omalla Idempotency-Key-avaimellaan, ja sovita teksti kunkin verkon rajoihin.
Ajastaako posts API YouTube-videoita?
YouTube ajastaa itse. Lataa video YouTuben rajapinnan kautta yksityisenä publishAt-arvolla, käyttäen GET /channels/:id?credentials=1 -pyynnöstä saatua tokenia, ja YouTube tekee siitä julkisen sillä hetkellä.
Voivatko käyttäjäni nähdä ajastetut julkaisunsa easyCoexistencen hallintapaneelissa?
Posts-näkymä kuuluu sinun tilillesi, joten tiimisi näkee siellä Needs attention, Coming up ja Published -osiot sekä toiminnot Cancel, Retry ja Dismiss. Käyttäjäsi näkevät kalenterin, jonka tuotteesi rakentaa GET /posts -pyynnöstä.
Mitä easyCoexistence maksaa sosiaalisen median ajastimelle?
US$ 9:stä US$ 0,75:een yhdistettyä tiliä kohden kuukaudessa, hinta laskee kun käyttäjäsi yhdistävät lisää, ajastus mukana ja ensimmäiset 3 päivää ilmaisia.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu