Instagram API-fouten: wat de veelvoorkomende foutcodes betekenen
De veelvoorkomende Instagram API-fouten zijn 190 bij een verlopen of ongeldig token, 4, 17 en 80002 bij snelheidslimieten, 9004 voor media die Meta niet kan ophalen, 9007 voor een video die nog wordt verwerkt, 9 voor de dagelijkse publicatielimiet, en 10 met subcode 2534022 voor een DM buiten het berichtenvenster. Elke fout komt als JSON met een code, vaak een subcode die het precieze geval benoemt, en een bericht.
easyCoexistence regelt de verbindingskant van deze fouten: het vernieuwt de Instagram-toegang voordat die verloopt, controleert het account elke 6 uur en mailt je wanneer het opnieuw moet worden verbonden.
Graph API-code voor een toegangstoken dat is verlopen, ingetrokken of anderszins ongeldig is.
Foutcode voor de Business Use Case-snelheidslimiet van Instagram.
Subcode, onder code 9, voor een account dat de dagelijkse API-publicatielimiet heeft bereikt.
Subcode, onder code 9004, voor media die Meta niet kon ophalen van de opgegeven URL.
Subcode, onder code 200, wanneer het account de toegang tot zijn Instagram-berichten heeft uitgeschakeld.
Hoe lees je een Instagram API-fout?
Elke fout is een JSON-object onder error. code is de brede categorie, error_subcode benoemt het specifieke geval en is meestal het nuttigste van de twee, en message beschrijft het. Veel fouten bevatten ook error_user_title en error_user_msg, tekst bedoeld voor de gebruiker, en is_transient. fbtrace_id identificeert het verzoek voor de Meta-support en verloopt snel, dus log het op het moment dat de fout optreedt.
Wat betekenen toegangs- en rechtenfouten?
Fouten over wie wat mag doen, met de oplossing per fout:
- 190: het toegangstoken is verlopen, ingetrokken of anderszins ongeldig; subcode 463 betekent verlopen, 467 ongeldig en 460 een gewijzigd wachtwoord. Een nieuw token lost het op, wat voor een verbonden account betekent dat je opnieuw verbindt.
- 10: toestemming geweigerd. Een recht is nooit verleend of is inmiddels ingetrokken.
- 200 tot 299: een specifiek recht ontbreekt, bijvoorbeeld 200 met subcode 2534041 wanneer het account de toegang tot zijn berichten heeft uitgeschakeld.
- 25, subcode 2207050: het account is beperkt, inactief of gecontroleerd; de eigenaar moet inloggen in de Instagram-app en doen wat erom wordt gevraagd.
Wat betekenen snelheidslimietfouten?
Throttling, en alles ervan is tijdelijk:
- 4: te veel aanroepen vanuit de app; wacht en probeer het opnieuw, of verlaag het aantal verzoeken.
- 17: te veel aanroepen voor de gebruiker; dezelfde oplossing geldt.
- 80002: de Business Use Case-limiet van Instagram, berekend per app en account op basis van de vertoningen van het account: 4.800 aanroepen per vertoning over 24 uur.
- 613, subcode 2534040: te veel berichtaanroepen; pauzeer en probeer het later opnieuw.
Wat betekenen publicatiefouten over het media-bestand?
Fouten over het bestand en waar het gehost wordt; alleen de timeout is het waard om opnieuw te proberen zoals het nu is:
- 9004, subcode 2207052: Meta kon de media niet ophalen van de URL; zorg dat die geldig en openbaar is.
- -2, subcode 2207003: het downloaden duurde te lang; dit is het waard om opnieuw te proberen.
- 36000, subcode 2207004: de afbeelding is groter dan 8 MB.
- 36001, subcode 2207005: het afbeeldingsformaat wordt niet ondersteund; gebruik JPEG.
- 36003, subcode 2207009: de beeldverhouding valt buiten 4:5 tot 1,91:1.
- 352, subcode 2207026: het videoformaat wordt niet ondersteund; gebruik MOV of MP4.
Wat betekenen publicatiefouten over timing en limieten?
Fouten over wanneer en hoeveel, de meeste opgelost door te wachten of opnieuw te beginnen:
- 9007, subcode 2207027: de media is nog niet klaar; wacht tot de
status_codevan de container FINISHED aangeeft. - 24, subcode 2207008: de container bestaat niet of is verlopen; probeer het één of twee keer opnieuw binnen 30 seconden tot 2 minuten, en maak dan een nieuwe aan.
- -2, subcode 2207020: de media is verlopen; maak een nieuwe container aan.
- 9, subcode 2207042: het account heeft de dagelijkse publicatielimiet bereikt; probeer het de volgende dag opnieuw.
- 100, subcode 2207028: een carrousel heeft 2 tot 10 items nodig.
- 36004, subcode 2207010: het bijschrift is te lang; Meta's limieten zijn 2.200 tekens en 20 @-tags, en de referentie noemt 30 hashtags, hoewel Instagram er 5 per post toestaat.
- 4, subcode 2207051: Instagram heeft de actie beperkt vanwege vermoedelijke spam.
Wat betekenen berichtfouten?
Fouten uit DM's en privé-reacties:
- 10, subcode 2534022: het bericht is buiten het toegestane venster verzonden; wacht tot de persoon weer schrijft.
- 100, subcode 2534014: geen overeenkomende Instagram-gebruiker; gebruik de Instagram-scoped ID uit de webhook, niet een Instagram-gebruikers-ID.
- 100, subcode 2534025: op de reactie kan geen privé-reactie worden gestuurd.
- 100, subcode 2534037: een andere app, inclusief Business AI van Meta zelf, beheert het gesprek.
- 551, subcode 1545041: de persoon is op dit moment niet beschikbaar.
Wat betekenen inzichtfouten?
Verzoeken om inzichten mislukken op drie gedocumenteerde manieren:
- 10, niet genoeg kijkers voor de media om inzichten te tonen: een Story-metric onder 5.
- Een uitgefaseerde metric, zoals impressions sinds 21 april 2025, geeft een fout terug; vraag in plaats daarvan om views.
- Een onbekende fout wanneer een van de meerdere gevraagde metrics de gevraagde uitsplitsing niet ondersteunt.
Welke fouten zijn het waard om opnieuw te proberen?
Alleen de tijdelijke: codes 1 en 2, de Instagram-serverfouten 2207001 en 2207032, de downloadtimeout 2207003, de kortstondige 2207008, en snelheidslimieten zodra de wachttijd voorbij is. Al het andere geeft hetzelfde antwoord totdat er iets verandert, of het bestand, de URL, een recht, de staat van het account of het venster van de persoon, en opnieuw proberen verbruikt alleen de snelheidslimiet.
Veelgemaakte fouten
- Een format- of groottefout opnieuw proberen. 2207004, 2207005, 2207009 en 2207026 falen op dezelfde manier totdat de media verandert.
- 9007 als mislukking zien. De video wordt nog verwerkt; publiceer zodra de container FINISHED aangeeft.
- Alleen de code lezen. Codes zoals 10 en 100 dekken veel gevallen, en de subcode is wat dit ene geval benoemt.
- fbtrace_id uit de logs laten vallen. De Meta-support vraagt erom, en het verloopt kort na de fout.
Claude, ChatGPT of je eigen code roepen daarna de officiële API van Meta aan met een token dat actueel blijft. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Wat betekent fout 190 op Instagram?
Het toegangstoken is verlopen, ingetrokken of anderszins ongeldig, bijvoorbeeld na een wachtwoordwijziging. Een nieuw token lost het op, en voor een verbonden account betekent dat opnieuw verbinden.
Waarom mislukt publiceren met 9004?
Meta kon de media niet ophalen van de opgegeven URL, subcode 2207052. Controleer of de link geldig en openbaar is, zonder login ervoor, op het moment dat de post wordt gepubliceerd.
Wat is fout 9007?
De video in de container wordt nog verwerkt, subcode 2207027. Controleer de status_code van de container en publiceer zodra die FINISHED aangeeft.
Wat is fbtrace_id in een Instagram API-fout?
Een identificatie van het mislukte verzoek, die de Meta-support vraagt wanneer je een probleem meldt. Het verloopt kort na de fout, dus schrijf het op het moment zelf naar je logs.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op