En svensk e-handel, domänåterförsäljare, byrå eller säkerhetsgrupp kan behöva kontrollera hundratals eller tusentals namn. Målet kan vara att hitta ett ledigt .se-namn, inventera kunders domänportföljer, följa förfallodatum eller samla DNS- och TLS-signal före en migrering. Ett batch-API gör arbetet möjligt att upprepa, men skalar också felaktiga antaganden. Därför måste du först definiera resultatets betydelse och sedan bygga kö, begränsning, återförsök och rapportering kring den.
Det första designbeslutet är om jobbet ska besvara tillgänglighet eller registrering. Ett namn som inte kan hittas i en viss teknisk sökning är inte automatiskt ledigt. Ett timeout- eller rate-limit-svar är unknown. För .se ska användningen av Internetstiftelsens sökdata och eventuella kommersiella begränsningar beaktas. Ett kommersiellt bulkflöde behöver därför ha tydligt syfte, respekt för villkor och en källa som är avsedd för den typ av automation ni vill bygga.
Börja med ett konkret batchmål
Skriv en jobbdefinition innan du väljer endpoint. För ett namnurval kan du behöva normalisera Unicode, kontrollera syntax och returnera status för varje kandidat. För portföljinventering behöver du kanske registrering, registrar, DNS, TLS och förändringstid. För migrering vill du ha en baslinje med A, AAAA, CNAME, MX, TXT, certifikat och slutlig URL. Ett jobb som blandar alla syften utan separata fält blir svårt att tolka och dyrt att köra.
- Jobb-ID, skapad tid, beställare och definierat ändamål.
- Inputrad med originalnamn och normaliserad representation.
- Kontrolltyp och version av vald kontrollpolicy.
- Status per rad: present, absent, unknown, invalid eller not requested.
- Källa, observationstid, cache och svarsklass.
- Felkod, återförsöksantal och föreslagen nästa åtgärd.
Lägg in ett litet representativt testurval före ett stort jobb. Ta med en känd registrerad domän, en säkert genererad frånvarokandidat, ett IDN, en felaktig input och en domän där svaret förväntas bli osäkert. Jämför resultatet manuellt med en auktoritativ kontroll. Om pilotens semantik är fel ska du stoppa innan felet kopieras till hela kundlistan.
Normalisera utan att tappa originalet
Domännamn kan komma med protokoll, versaler, punkt på slutet, www eller sökväg. Validera och normalisera till den form kontrollen kräver, men spara originalinput för rapporten. Hantera Unicode och punycode konsekvent och visa båda när en IDN kan förväxlas. Ta inte bort en inputrad bara för att den är ogiltig. Returnera invalid med förklaring så att beställaren kan rätta källan.
Separera syntaktisk giltighet från registreringsstatus. Ett korrekt formaterat namn kan vara upptaget eller ledigt, och ett korrekt format kan ändå ha ett resultat som inte stöds av den valda källan. För varje rad ska klienten kunna se vad som faktiskt kontrollerades. En tom sträng, ett exception eller en generisk HTTP-felsida får inte omvandlas till absent.
Designa kö och begränsningar
Stora batchjobb behöver begränsad samtidighet, en total budget och per-källa eller per-domän-regler. Börja med en låg takt och öka bara när svarstid, fel och rate limits är stabila. Blanda inte obegränsade återförsök med en hög parallellism. Exponentiell backoff med jitter kan minska toppar, men ett svar som uttryckligen säger att kvoten är slut ska markeras och återupptas senare i stället för att hamras omedelbart.
Sätt timeout per kontroll och timeout för hela jobbet. Ett batchjobb som håller en webbförfrågan öppen i timmar är svårt att återuppta. Returnera jobbstatus, antal slutförda, antal unknown, antal fel och nästa polling- eller hämtningsväg. Idempotensnyckel gör att en klient kan upprepa skapandet efter ett nätfel utan att skapa två identiska jobb.
Hantera partial success som ett förstaklassresultat
Ett stort jobb kommer ofta att bli delvis lyckat. Vissa namn kan ha ett tydligt svar, andra kan timeouta eller kräva senare kontroll. Jobbstatusen bör därför kunna vara completed with unknown results, inte bara success eller failed. Klienten behöver få veta vilka rader som är klara, vilka som kan återupptas och vilka som är permanent ogiltiga. Annars riskerar en användare att ta beslut från en rapport där hälften av namnen aldrig kontrollerades.
- Validera input och returnera radvisa invalid-resultat.
- Kör kontroller med bounded concurrency och tydlig tidsbudget.
- Spara resultat direkt i stället för först när hela jobbet är klart.
- Märk unknown, rate limited, unavailable och cached separat.
- Tillåt säkert återupptag från senast bekräftade rad.
- Exportera en sammanfattning med täckning och begränsningar.
- Behåll rå provenance enligt avtalad lagring och åtkomst.
Separera cache från aktuell kontroll
Cache kan minska kostnad och belastning, men ett gårdagens svar är inte samma sak som en färsk kontroll. Visa cacheålder, källtid och kontrolltid. För förfallodatum, registrarstatus och förändringsbevakning kan en färskare kontroll behövas än för en långsamt förändrad profil. Definiera TTL per fälttyp och låt beställaren välja en maximal tillåten ålder där det är relevant.
En cacheträff ska fortfarande vara en tydlig outcome. Om källan är tillfälligt otillgänglig får en gammal present-status inte behandlas som ett nytt bevis på att allt är oförändrat utan att åldern visas. Vid bevakning kan den hjälpa till att jämföra senaste säkra baslinje, men ett larm ska visa att aktuell observation saknas. På så sätt blandas inte stabilitet med aktuell tillgänglighet.
Bygg en rapport som passar svenska team
En marknadsgrupp vill ofta se namn, tillgänglighet och idéer. IT behöver DNS, registrar, TLS och fel. Säkerhet behöver bevis, osäkerhet och prioritet. Ekonomi behöver kostnad, förfallodatum och ansvar. Exportera ett gemensamt radformat med tekniska fält och skapa sammanfattningar för respektive mottagare. Skriv inte en domän som ledig när svaret egentligen är unknown. Formulera i stället nästa åtgärd, exempelvis manuell kontroll eller senare upprepning.
Lägg till exempel i API-dokumentationen: en giltig registrerad domän, en invalid rad, en rate-limited rad och ett jobb med partial success. Visa statuskoder, pagination, polling, idempotens och hur klienten ska hantera ett resultat som förändras mellan två körningar. Ett tydligt kontrakt minskar risken att en byrå bygger en egen felaktig tolkning av unknown.
Respektera register och användningsvillkor
Innan du automatiserar en stor .se-sökning, kontrollera aktuell officiell information om vilka data som får hämtas, hur de får användas och vilka begränsningar som gäller. En privat due diligence-lista och en publik kommersiell databas är inte samma användning. Begränsa personuppgifter, följ rate limits och dokumentera källa och syfte. Om den planerade volymen eller användningen inte ryms i villkoren ska du ändra designen eller inhämta rätt tillstånd, inte anta att ett API gör allt tillåtet.
Samma disciplin gäller externa RDAP-källor. RDAP ger strukturerade svar men har rate limits, registryvariation och redigerade fält. Spara källa, status och osäkerhet per rad. Ett 403, 429, 5xx, timeout eller malformed response är unknown eller unavailable enligt kontraktet. Det är särskilt viktigt när en klient vill köpa ett namn eller skicka ett varumärkeslarm baserat på batchresultatet.
Testa även när allt går fel
Testsviten ska täcka en blandning av lyckade och misslyckade rader, tom input, stora men tillåtna jobb, för stora jobb, avbruten polling, duplicerade idempotensnycklar, cacheträff, rate limit och återupptag. Testa att ett fel vid resultatlagring inte gör redan färdiga rader osynliga. Testa också att en klient inte kan läsa ett annat teams jobb genom att gissa jobb-ID eller ändra pagination.
Kör en liten produktionslik pilot och jämför stickprov mot en manuell officiell kontroll. Följ svarstid, unknown-andel, återförsök och kostnad. Om en viss inputtyp ger många fel, förbättra normaliseringen eller dokumentationen innan du skalar. Ett snabbt batchjobb som skapar osäkra beslut är sämre än ett långsammare jobb som visar vad som faktiskt kontrollerades.
En införandeplan i tre steg
Första steget är ett litet synkront urval med samma statusmodell som det framtida batchjobbet. Andra steget är asynkron körning med polling, återupptagning, idempotens och export. Tredje steget är bevakning med baslinjer, förändringslarm och ansvariga. Flytta inte direkt från en manuell sökning till tusentals namn utan att först testa semantik, registervillkor och driftgränser.
När arbetssättet är på plats kan batch-API:t bli en trygg byggsten för svenska domänteam. En byrå kan kontrollera kundportfölj inför ett möte, ett säkerhetsteam kan följa certifikat och ett produktteam kan validera ett nytt namnurval. Alla får mer värde när resultatet visar provenance, osäkerhet, status och nästa steg i stället för ett förenklat ja eller nej.
Sätt en ägare för varje större jobb och lägg in stoppregler när unknown eller rate limit överstiger en avtalad nivå. Den regeln skyddar både källan och beslutskvaliteten. Efter körningen ska någon granska sammanfattningen, inte bara ladda ned CSV-filen. Ett batchjobb är först färdigt när resultaten är tolkade, begränsningarna är synliga och eventuella uppföljningar har fått en ansvarig.
Gör omkörning säker
Ett nätfel kan inträffa efter att källan svarat men innan klienten fått bekräftelse. Idempotensnyckel och ett stabilt rad-ID gör att omkörningen inte skapar dubbla åtgärder eller två fakturerbara jobb. Spara varje rad med kontrollstatus och källa innan du skickar sammanfattningen. Om en klient ber om en ny kontroll ska den uttryckligen välja fresh check i stället för att råka skriva över en tidigare observation utan jämförelse.
Sätt gränser för storlek, filformat och antal domäner per jobb. En mycket stor lista kan delas upp på ett sätt som bevarar kund, kampanj eller portfölj som logisk enhet. Returnera tydligt om bara en del av jobbet skapades. När en klient laddar upp en fil ska felaktiga rader få radnummer och förklaring, medan giltiga rader kan fortsätta om kontraktet tillåter partial acceptance.
Säkra åtkomst och resultat
Batchresultat kan avslöja kundportföljer, varumärkesplaner och tekniska fel. Kontrollera att den som skapar ett jobb bara kan läsa sitt eget resultat och att exportlänkar har begränsad livslängd och rätt behörighet. Logga jobbskapande, polling, export och avbrutna försök utan att lägga råa personuppgifter i allmänna loggar. Om en byrå arbetar för flera svenska kunder ska kundgränsen vara tydlig både i API-kontrakt och i rapporten.
Skriv en SLA-liknande förväntan utan att lova en absolut extern svarstid. Beskriv normal behandling, vad som händer vid rate limit, hur unknown återupptas och hur länge resultatet är användbart. Kunder kan då planera manuella stickprov och beslut utan att tolka en kö som att registreringsstatus är permanent. Transparens om begränsningar stärker förtroendet mer än ett konstgjort grönt resultat.
Följ upp varje större körning med en kvalitetskontroll på ett litet stickprov. Välj både present, absent och unknown och jämför mot en officiell eller manuellt verifierad källa. Om semantiken ändrats efter en källa eller policyversion ska rapporten visa det. Lägg in versionsfält så att två CSV-filer från olika månader inte blandas utan att någon vet varför resultatet skiljer sig.