Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Mengapa sambungan API Instagram berhenti berfungsi, dan cara mengekalkannya aktif

Sambungan API Instagram terhenti apabila Meta tidak lagi menerima tokennya atau akaun tidak lagi layak: token jangka panjang yang tidak disegarkan selama 60 hari, pertukaran kata laluan, kebenaran atau keseluruhan aplikasi dialih keluar oleh pemilik, pertukaran kepada akaun peribadi, atau sekatan ke atas akaun. Setiap satu memulangkan ralat tersendiri, dan kebanyakannya dibetulkan apabila pemilik log masuk semula.

easyCoexistence memantau setiap sambungan Instagram sepanjang masa: ia menyegarkan token jauh sebelum 60 hari habis, menyemak akaun setiap 6 jam, dan menghantar e-mel kepada anda sekali apabila Meta menolak akses serta menghantar channel.disconnected kepada platform, supaya sambungan yang terputus pulih dengan satu log masuk.

60 days

Token Instagram yang tidak disegarkan dalam tempoh 60 hari akan tamat tempoh dan tidak lagi boleh disegarkan.

460

Subkod Graph API di bawah kod 190, bagi sesi yang tamat akibat pertukaran kata laluan; orang itu perlu log masuk semula.

1 hour

Daripada penghantaran webhook pemesejan yang gagal, sebelum Meta melumpuhkannya dan menyahlanggan aplikasi daripada akaun.

28 days

Meta boleh menamatkan akses aplikasi kepada kebenaran atau ciri yang tidak digunakannya dalam tempoh 28 hari.

6 hours

Kekerapan easyCoexistence menyemak setiap akaun Instagram yang disambungkan, dan memperbaharui tokennya jauh sebelum 60 hari habis.

Mengapa sambungan API Instagram berhenti berfungsi?

Kerana Meta berhenti menerima token itu, atau akaun berhenti layak untuk API. Dokumentasi Meta menamakan punca-puncanya, setiap satu dengan apa yang dipulangkan API dan langkah yang memulihkan akses. Kebanyakannya muncul dahulu sebagai panggilan yang gagal, sebab itulah semakan di bawah memeriksanya mengikut jadual:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA 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 offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

Bila token tamat tempoh, dan bila ia masih boleh disegarkan?

Dengan Instagram Login, token jangka panjang tahan 60 hari dari penyegaran terakhir. Penyegaran dengan grant_type=ig_refresh_token memberinya 60 hari lagi, dengan syarat ia sekurang-kurangnya 24 jam, belum tamat tempoh, dan pemilik memberi kebenaran instagram_business_basic. Selepas 60 hari berlalu, panggilan gagal dengan kod 190 dan hanya log masuk baharu yang membantu. Dengan Unified Login, konfigurasi menentukan sama ada token tamat tempoh sama sekali.

Apa yang dilakukan oleh pertukaran kata laluan dan kebenaran yang dialih keluar?

Pertukaran kata laluan boleh menamatkan sesi yang dimiliki token itu: panduan ralat Graph API Meta melaporkannya sebagai kod 190 dengan subkod 460 dan menyatakan orang itu mesti log masuk semula ke aplikasi. Kebenaran yang tidak pernah diberikan atau telah dialih keluar memulangkan kod 10, atau kod dari 200 hingga 299; pada DM, kod 200 dengan subkod 2534041 bermakna pemilik mematikan akses kepada mesej. Terma Platform Meta juga membenarkannya menamatkan akses aplikasi kepada kebenaran atau ciri yang tidak digunakan selama 28 hari.

Apa yang berlaku apabila pemilik mengalih keluar aplikasi?

Akses aplikasi kepada data bukan awam akan tamat. Pemilik mengalih keluar aplikasi dalam Instagram di bawah Kebenaran laman web, Aplikasi dan laman web, Aktif, dan Meta memanggil URL panggilan balik nyahautorisasi yang disimpan dalam tetapan log masuk perniagaan aplikasi. Pusat Bantuan Instagram menyatakan aplikasi yang dialih keluar hanya boleh mencapai maklumat awam akaun dari saat itu, jadi sambungan tamat sehingga pemilik log masuk semula.

Apa yang berlaku apabila akaun bertukar jenis atau disekat?

Kedua-duanya membawa akaun keluar daripada apa yang dilayani API. API Meta hanya berfungsi dengan akaun profesional, dan jadual penyelesaian masalah Unified Login memberi mesej (#10) Access is denied because the instagram account type is not business or creator bagi akaun yang ditukar kepada peribadi; pemilik menukar semula, kemudian menyambung semula. Akaun yang disekat, tidak aktif atau dalam semakan memulangkan kod 25 dengan subkod 2207050, yang diselesaikan pemilik dalam aplikasi Instagram.

Bagaimana webhook berhenti sampai?

Melalui endpoint yang gagal. Meta mencuba semula pemberitahuan Instagram sehingga 36 jam, tetapi penghantaran pemesejan lebih ketat: selepas 15 minit kegagalan, amaran dihantar ke akaun pemaju, dan selepas sejam Meta menghantar amaran Webhooks Disabled serta menyahlanggan aplikasi daripada akaun. Apabila endpoint berfungsi semula, POST /<IG_ID>/subscribed_apps dengan medan yang sama menghidupkan semula pemberitahuan.

Bagaimana anda perasan gangguan sebelum pengguna?

Dengan menyemak sambungan mengikut jadual, bukan menunggu siaran gagal:

  • Simpan expires_in daripada setiap pertukaran token dan segarkan jauh sebelum hari ke-60, apabila token sudah berusia sehari.
  • Buat panggilan disahkan yang ringan mengikut jadual, seperti GET /me?fields=user_id,username, dan anggap kod 190 atau 102 sebagai keperluan sambung semula.
  • Sediakan URL panggilan balik nyahautorisasi, supaya pengalihan keluar dalam tetapan Instagram sampai kepada anda serta-merta.
  • Baca Developer Alerts dan e-mel perniagaan pada aplikasi, tempat Meta menghantar notis webhook dan semakan.
  • Log kod, subkod dan fbtrace_id bagi setiap ralat mengikut akaun, supaya sekatan dapat dibezakan daripada permintaan yang salah.

Bagaimana anda menyambung semula setiap kes?

Kebanyakan punca berakhir dengan langkah yang sama, iaitu log masuk baharu oleh pemilik akaun, yang mengeluarkan kod dan token baharu. Pengecualiannya ialah tetapan yang diubah pemilik dalam aplikasi Instagram:

  • Token tamat tempoh, pertukaran kata laluan, aplikasi atau kebenaran dialih keluar: hantar pemilik melalui log masuk semula dan biarkan mereka meluluskan kebenaran.
  • Akaun peribadi: tukar kembali kepada Perniagaan atau Pencipta dalam aplikasi Instagram, kemudian log masuk semula.
  • Mesej dimatikan: hidupkan Benarkan akses kepada mesej di bawah Alat yang disambungkan; log masuk baharu tidak diperlukan.
  • Akaun disekat: lengkapkan apa yang diminta aplikasi Instagram; log masuk baharu tidak mengubah apa-apa.
  • Webhook dilumpuhkan: betulkan endpoint, kemudian langgan akaun itu semula.

Apa yang dilakukan easyCoexistence untuk mengekalkan sambungan?

Ia memantau setiap akaun Instagram yang disambungkan sepanjang masa. Ia menyegarkan token apabila kurang daripada 20 daripada 60 hari berbaki, menyemak akaun setiap 6 jam dengan GET /me, dan menandakan sambungan untuk disambung semula sebaik sahaja Meta menolak token, sama ada dalam semakan itu atau dalam panggilan alat. Ia menjawab penghantaran webhook Meta serta-merta dan memajukannya kemudian, dan apabila pemilik mengalih keluar aplikasi dalam tetapan Instagram, panggilan balik nyahautorisasi Meta menamatkan sambungan dan mengeluarkannya daripada bil.

Bagaimana easyCoexistence memberitahu anda, dan bagaimana anda menyambung semula?

Sekali sahaja, melalui e-mel, dengan menamakan akaun dan butang ke halaman saluran; platform juga menerima acara channel.disconnected yang ditandatangani. Sehingga pemilik bertindak, list_social_accounts menunjukkan status dan ralat terakhir Meta, dan alat membalas bahawa akaun perlu disambung semula. Menyambung semula ialah satu log masuk dengan akaun Instagram yang sama, yang menghidupkan semula sambungan yang sama beserta tetapannya.

Kesilapan biasa

  • Menyegarkan token hanya selepas panggilan gagal. Apabila ia tamat tempoh, Meta menolak penyegaran, jadi jadualkan pembaharuan semasa token masih sah.
  • Menghantar akaun yang disekat kembali melalui log masuk. Kod 25 dengan subkod 2207050 ialah keadaan akaun, yang diselesaikan pemilik dalam aplikasi Instagram.
  • Membiarkan URL panggilan balik nyahautorisasi tidak ditetapkan. Pengalihan keluar dalam tetapan Instagram kemudian hanya muncul apabila panggilan seterusnya gagal.
  • Membetulkan endpoint yang gagal dan kemudian menunggu. Selepas amaran Webhooks Disabled, pemberitahuan kekal dimatikan sehingga akaun dilanggan semula dengan POST /<IG_ID>/subscribed_apps.
Menggunakan EasyCoexistence untuk ini

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah menggunakan token Instagram menghalangnya daripada tamat tempoh?

Tidak. Hanya penyegaran yang memanjangkan token jangka panjang, dan token yang melalui 60 hari tanpa penyegaran akan tamat tempoh walau sekerap mana pun ia digunakan.

Adakah Instagram mengalih keluar aplikasi perniagaan selepas 90 hari tidak digunakan?

Tidak. Pusat Bantuan Instagram menyatakan aplikasi dengan kebenaran untuk mengurus akaun perniagaan dan pencipta tidak tamat tempoh selepas 90 hari tidak aktif.

Adakah akaun yang terputus masih dikira dalam bil easyCoexistence?

Ya, sehingga anda menyambung semula atau mengalih keluarnya. Akaun yang pemiliknya mengalih keluar aplikasi dalam tetapan Instagram keluar daripada kiraan sebaik sahaja Meta melaporkan pengalihan itu.

Berapa kos easyCoexistence untuk memantau akaun Instagram?

Pemantauan disertakan dengan setiap sambungan: US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada