Veelvoorkomende foutmeldingen
Wanneer een verzoek mislukt, retourneert Bird een gestructureerde fout met een machineleesbare code, een melding, een documentatielink en een verzoek-ID. Gebruik de code in programmalogica. Als je ondersteuning nodig hebt, selecteer je Feedback > Contact us en vermeld je het verzoek-ID. Zie de API-foutreferentie voor de volledige catalogus.
Validatiefouten
Deze betekenen dat Bird je verzoek begreep, maar dat er iets in niet acceptabel is. De fout vermeldt het specifieke veld of de voorwaarde die niet klopt.
Alle ontvangers onderdrukt
Wat het betekent: elke ontvanger in je verzending staat op je suppressielijst, dus er was niets meer om te bezorgen en de verzending is geweigerd.
Waarschijnlijke oorzaak: je stuurt naar adressen die eerder hard-bounceten, een klacht indienden of zich afmeldden, vaak een teken dat je een oude of niet-opgeschoonde lijst opnieuw mailt. Als slechts enkele ontvangers onderdrukt zijn, gaat de verzending door voor de rest en worden de onderdrukte als afgewezen getoond; deze fout verschijnt alleen als het ze allemaal zijn.
De oplossing: controleer welke adressen onderdrukt zijn en waarom, en verwijder ze uit je eigen lijst. Waarom is mijn e-mail afgewezen? legt uit hoe suppressieafwijzingen zichtbaar worden, en de suppressiegids behandelt het beheren van de lijst.
Onboarding-ontvanger niet toegestaan
Wat het betekent: je verstuurt vanaf het gedeelde onboardingdomein van Bird naar iemand die geen geverifieerd lid is van je werkruimte.
Waarschijnlijke oorzaak: het gedeelde domein bezorgt alleen aan geverifieerde werkruimteleden en sandbox-testadressen.
De oplossing: als je echte ontvangers wilt e-mailen, verifieer je je eigen verzenddomein, waarmee de beperking volledig vervalt. Zie Verzenden vanaf het gedeelde domein voor de beperkingen en hoe je ze opheft.
Ontbrekend of ongeldig veld
Wat het betekent: een verplicht veld ontbreekt, een waarde is ongeldig, of het verzoek combineert incompatibele velden.
Waarschijnlijke oorzaak: het verzoek komt niet overeen met het schema van de operatie of combineert incompatibele velden. De foutdetails identificeren elk falend veld.
De oplossing: lees de foutdetails en corrigeer de genoemde velden.
Limietfouten
Wat het betekent: het verzoek overschreed een operatie-, account- of verzendlimiet.
Waarschijnlijke oorzaak: een piek overschreed een API-limiet, of een verzending overschreed een quotum zoals de ontvangerslimiet van het gedeelde onboardingdomein.
De oplossing: volg de herstelstappen en de Retry-After-waarde in de fout als die aanwezig is. Probeer tijdelijke limieten opnieuw met backoff. Wacht voor de dagelijkse onboardinglimiet op de UTC-dagreset of verifieer je eigen verzenddomein. Het e-mailgezondheidslabel throttled is diagnostisch en veroorzaakt geen API-limietfout.
Authenticatiefouten
Wat het betekent: Bird kon je inloggegevens niet accepteren.
Waarschijnlijke oorzaak: een van drie dingen, in grove volgorde van frequentie:
- Verkeerde, verlopen of ingetrokken API-sleutel: de sleutel is verkeerd getypt, afgekapt, verlopen of niet meer actief. Een secret wordt alleen getoond wanneer de sleutel wordt aangemaakt of geroteerd.
- Sleutel gebruikt tegen de verkeerde regio: API-sleutels zijn regionaal en een sleutel werkt alleen tegen de servers van zijn eigen regio. Als je sleutel in de ene regio is aangemaakt en je code de andere aanroept, mislukt de authenticatie. Het sleutelprefix vertelt je bij welke regio hij hoort.
- Ontbrekende sleutel: het verzoek bevatte helemaal geen inloggegevens, vaak een omgevingsvariabele die leeg is in de omgeving waar het misgaat.
De oplossing: controleer of de sleutel bestaat en actief is in je dashboard, of je code hem meestuurt, en of je het regionale adres aanroept dat bij de sleutel hoort. Maak bij twijfel een nieuwe sleutel aan en wissel hem in.
Domein niet geverifieerd
Wat het betekent: het verzenddomein heeft de verificatie niet voltooid, dus Bird kan er niet vanaf verzenden.
Waarschijnlijke oorzaak: de DNS-records ontbreken, propageren nog of zijn onjuist, of de records zijn gewijzigd na verificatie. Zie de domeinverificatiechecklist voor de verwachte doorlooptijd.
De oplossing: open de domeinpagina in het dashboard om het ontbrekende record te identificeren. Gebruik de domeinverificatiechecklist om het te corrigeren. Terwijl DNS propageert, gebruik je het gedeelde onboardingdomein voor testverzendingen.
Elke fout die je tegenkomt lezen
Match op de machineleesbare foutcode, want menselijk leesbare meldingen kunnen veranderen. Log het verzoek-ID. Als je ondersteuning nodig hebt, selecteer je Feedback > Contact us en vermeld je het. Volg de documentatielink voor foutspecifieke herstelstappen.
Volgende stappen
- API-foutreferentie (de volledige catalogus: elk fouttype, elke code en status)
- Waarom is mijn e-mail afgewezen?: de redenen achter afwijzingen per ontvanger
- Waarom toont e-mailgezondheid Throttled?: het diagnostische gezondheidslabel en de signalen erachter
- Verzenden vanaf het gedeelde domein: de ontvangers- en dagelijkse limietbeperkingen van het onboardingdomein
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Bekijk de gidsWhat happens when someone opts outBegrijp het conceptWhat is one-click unsubscribe, and how do I implement List-Unsubscribe?Ontdek de mogelijkheidEmail opt-outsVolg het leerpadOperate messaging reliably
Ontvang een implementatieoverzicht