Miksi Instagram API -yhteys lakkaa toimimasta ja miten sen saa pidettyä toimivana
Instagram API -yhteys lakkaa toimimasta, kun Meta ei enää hyväksy sen tokenia tai tili ei enää täytä vaatimuksia: pitkäkestoinen token jää 60 päiväksi uusimatta, salasana vaihtuu, omistaja poistaa oikeuden tai koko sovelluksen, tili vaihdetaan henkilötiliksi tai tiliin kohdistuu rajoitus. Jokainen palauttaa oman virheensä, ja useimmat korjautuvat, kun omistaja kirjautuu uudelleen sisään.
easyCoexistence valvoo jokaista Instagram-yhteyttä ympäri vuorokauden: se uusii tokenin hyvissä ajoin ennen 60 päivän umpeutumista, tarkistaa tilin 6 tunnin välein, lähettää sinulle sähköpostin kerran, kun Meta evää pääsyn, ja lähettää alustoille channel.disconnected-tapahtuman, joten katkennut yhteys palautuu yhdellä kirjautumisella.
Instagram-tokenit vanhenevat, eikä niitä voi enää uusia, jos niitä ei ole uusittu 60 päivän kuluessa.
Graph API:n alikoodi virhekoodin 190 alla tarkoittaa istunnon päättymistä salasanan vaihdon vuoksi; henkilö kirjautuu uudelleen sisään.
Epäonnistuneiden messaging-webhook-toimitusten osalta ennen kuin Meta poistaa ne käytöstä ja irrottaa sovelluksen tilistä.
Meta voi lopettaa sovelluksen pääsyn oikeuksiin tai ominaisuuksiin, joita sovellus ei ole käyttänyt 28 päivän jaksolla.
Tiheys, jolla easyCoexistence tarkistaa jokaisen yhdistetyn Instagram-tilin ja uusii sen tokenin hyvissä ajoin ennen 60 päivän umpeutumista.
Miksi Instagram API -yhteys lakkaa toimimasta?
Koska Meta lakkaa hyväksymästä tokenia tai tili lakkaa täyttämästä API:n vaatimuksia. Metan dokumentaatio nimeää syyt. Jokaiselle kerrotaan, mitä API palauttaa ja mikä vaihe palauttaa pääsyn. Useimmat näkyvät ensimmäisenä epäonnistuneena kutsuna, minkä vuoksi alla olevat tarkistukset etsivät niitä aikataulun mukaan:
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A new sign-in, if the owner wants it back |
| Switched to a personal account | (#10) Access is denied because the instagram account type is not business or creator. | Back to Business or Creator, then a new sign-in |
| Allow access to messages off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A working endpoint, then a new subscription |
Milloin token vanhenee ja milloin sitä voi vielä uusia?
Instagram Loginilla pitkäkestoinen token on voimassa 60 päivää viimeisestä uusimisesta. Uusiminen grant_type=ig_refresh_token-parametrilla antaa siihen 60 päivää lisää, jos token on vähintään 24 tuntia vanha, ei ole vanhentunut ja omistaja on myöntänyt oikeuden instagram_business_basic. Kun 60 päivää on kulunut, kutsut epäonnistuvat virhekoodilla 190, eikä auta muu kuin uusi kirjautuminen. Unified Loginilla kokoonpano määrää, vanhenevatko tokenit lainkaan.
Mitä salasanan vaihto ja poistettu oikeus tekevät?
Salasanan vaihto voi päättää session, johon token kuuluu. Metan Graph API -virheopas kirjaa sen virhekoodilla 190 ja alikoodilla 460 ja toteaa, että henkilön on kirjauduttava sovellukseen uudelleen. Oikeus, jota ei ole koskaan myönnetty tai joka on poistettu, palauttaa koodin 10 tai koodin väliltä 200–299. DM-viesteissä koodi 200 alikoodilla 2534041 tarkoittaa, että omistaja on sulkenut viestien käytön. Metan Platform Terms antaa sille myös oikeuden päättää sovelluksen pääsyn oikeuteen tai ominaisuuteen, jota ei ole käytetty 28 päivään.
Mitä tapahtuu, kun omistaja poistaa sovelluksen?
Sen pääsy ei-julkiseen dataan päättyy. Omistaja poistaa sovelluksen Instagramissa kohdasta ”Website permissions”, ”Apps and websites”, ”Active”, ja Meta kutsuu sovelluksen yrityskirjautumisen asetuksiin tallennettua deauthorize callback -URL-osoitetta. Instagramin ohjekeskuksen mukaan poistettu sovellus pääsee sen jälkeen käsiksi vain tilin julkisiin tietoihin, joten yhteys on ohi, kunnes omistaja kirjautuu uudelleen sisään.
Mitä tapahtuu, kun tili vaihtaa tyyppiä tai sitä rajoitetaan?
Kumpikin vie tilin API:n tukemisen ulkopuolelle. Metan API toimii vain ammatillisilla tileillä, ja sen Unified Login -vianmääritystaulukko antaa virheen (#10) Access is denied because the instagram account type is not business or creator henkilötiliksi vaihdetulle tilille. Omistaja vaihtaa takaisin ja yhdistää sitten uudelleen. Rajoitettu, passiivinen tai tarkistukseen jäänyt tili palauttaa koodin 25 alikoodilla 2207050, jonka omistaja ratkaisee Instagram-sovelluksessa.
Miten webhookit lakkaavat saapumasta?
Epäonnistuvan päätepisteen kautta. Meta yrittää uudelleen Instagram-ilmoitusta jopa 36 tunnin ajan, mutta viestitoimitukset ovat tiukempia: 15 minuutin epäonnistumisten jälkeen kehittäjätilille lähtee hälytys, ja tunnin jälkeen Meta lähettää ilmoituksen Webhooks Disabled ja irrottaa sovelluksen tilistä. Kun päätepiste toimii taas, POST /<IG_ID>/subscribed_apps samoilla kentillä kytkee ilmoitukset takaisin päälle.
Miten huomaat katkeamisen ennen käyttäjiä?
Tarkistamalla yhteyden aikataulun mukaan sen sijaan, että odottaisit julkaisun epäonnistumista:
- Tallenna
expires_injokaisesta tokenin vaihdosta ja uusimisesta hyvissä ajoin ennen 60. päivää, kun token on vuorokauden vanha. - Tee aikataulun mukaan halpa todennettu kutsu, kuten GET /me?fields=
user_id,username, ja käsittele virhekoodi 190 tai 102 uudelleenyhdistämisen merkkinä. - Ota vastaan deauthorize callback, jotta Instagramin asetuksista tehty poisto tavoittaa sinut heti.
- Lue Developer Alerts ja sovelluksen yrityssähköposti, johon Meta lähettää webhook- ja tarkistusilmoitukset.
- Kirjaa kunkin tilin jokaisen virheen koodi, alikoodi ja
fbtrace_id, jotta rajoitus erottuu huonosta pyynnöstä.
Miten yhdistät uudelleen kussakin tapauksessa?
Useimmat syyt päättyvät samaan vaiheeseen, tilin omistajan uuteen kirjautumiseen, joka antaa uuden koodin ja tokenin. Poikkeukset ovat asetuksia, joita omistaja muuttaa Instagram-sovelluksessa:
- Vanhentunut token, salasanan vaihto, poistettu sovellus tai oikeus: ohjaa omistaja kirjautumaan uudelleen ja hyväksymään oikeudet.
- Henkilötili: vaihda takaisin Business- tai Creator-tiliksi Instagram-sovelluksessa ja kirjaudu sitten uudelleen sisään.
- Viestit pois käytöstä: ota käyttöön ”Allow access to messages” kohdassa ”Connected tools”; uutta kirjautumista ei tarvita.
- Rajoitettu tili: suorita se, mitä Instagram-sovellus pyytää; uusi kirjautuminen ei muuta mitään.
- Pois käytöstä olevat webhookit: korjaa päätepiste ja tilaa tili sitten uudelleen.
Mitä easyCoexistence tekee yhteyden pitämiseksi toimivana?
Se valvoo jokaista yhdistettyä Instagram-tiliä ympäri vuorokauden. Se uusii tokenin, kun 60 päivästä on jäljellä alle 20, tarkistaa tilin 6 tunnin välein GET /me-kutsulla ja merkitsee yhteyden uudelleenyhdistettäväksi heti, kun Meta hylkää tokenin, joko tuon tarkistuksen tai työkalukutsun yhteydessä. Se vastaa Metan webhook-toimituksiin heti ja välittää ne myöhemmin. Kun omistaja poistaa sovelluksen Instagramin asetuksista, Metan deauthorize callback päättää yhteyden ja poistaa sen laskutuksesta.
Miten easyCoexistence kertoo sinulle ja miten yhdistät uudelleen?
Kerran, sähköpostitse, nimeten tilin ja painikkeen, joka vie kanavan sivulle. Alustoille lähetetään myös allekirjoitettu channel.disconnected-tapahtuma. Kunnes omistaja toimii, list_social_accounts näyttää tilan ja Metan viimeisimmän virheen, ja työkalut vastaavat, että tili täytyy yhdistää uudelleen. Uudelleenyhdistäminen on yksi kirjautuminen samalla Instagram-tilillä, joka elvyttää saman yhteyden asetuksineen.
Yleiset virheet
- Tokenin uusiminen vasta sen jälkeen, kun kutsu on epäonnistunut. Kun token on vanhentunut, Meta hylkää uusimisen, joten ajasta uusimiset sillä aikaa, kun token on vielä voimassa.
- Rajoitetun tilin lähettäminen takaisin kirjautumiseen. Virhekoodi 25 alikoodilla 2207050 kuvaa tilin tilaa, jonka omistaja korjaa Instagram-sovelluksessa.
- Deauthorize callbackin jättäminen asettamatta. Poisto Instagramin asetuksista tulee silloin näkyviin vasta, kun seuraava kutsu epäonnistuu.
- Epäonnistuneen päätepisteen korjaaminen ja odottaminen. Webhooks Disabled -hälytyksen jälkeen ilmoitukset pysyvät pois päältä, kunnes tili tilataan uudelleen komennolla POST /<IG_ID>/subscribed_apps.
US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksien lisääntyessä, ja ensimmäiset 3 päivää ovat ilmaiset.
Usein kysytyt kysymykset
Estääkö Instagram-tokenin käyttäminen sen vanhenemisen?
Ei. Vain uusiminen pidentää pitkäkestoista tokenia, ja token, jota ei ole uusittu 60 päivään, vanhenee riippumatta siitä, kuinka usein sitä on käytetty.
Poistaako Instagram yritykselle tarkoitetun sovelluksen 90 päivän käyttämättömyyden jälkeen?
Ei. Instagramin ohjekeskuksen mukaan sovellukset, joilla on oikeudet yritys- ja Creator-tilien hallintaan, eivät vanhene 90 päivän passiivisuuden jälkeen.
Lasketaanko katkennut tili yhä easyCoexistence-laskussa?
Kyllä, kunnes yhdistät sen uudelleen tai poistat sen. Tili, jonka omistaja on poistanut sovelluksen Instagramin asetuksista, poistuu laskennasta heti, kun Meta ilmoittaa poistosta.
Paljonko easyCoexistence maksaa Instagram-tilin valvonnasta?
Valvonta kuuluu jokaiseen yhteyteen: US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksien lisääntyessä, ja ensimmäiset 3 päivää ovat ilmaiset.
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