Zoek IP-adressen op in batches
Stuur een lijst met IP-adressen naar één endpoint en ontvang een bijbehorende lijst met locatieresultaten. De bulk IP-lookup-API van Watch-IP accepteert tot 100 IPv4- en IPv6-adressen per verzoek voor backend-verrijkingsworkflows. Bewaar je geheime sleutel op de server, verwerk het antwoord in de volgorde van invoer, en behandel ontbrekende records zonder de koppeling met je oorspronkelijke gegevens te verliezen.
Eén verzoek, tot 100 adressen
Gebruik POST /v1/lookup met een JSON-object dat een ips-array bevat. Elke geaccepteerde batch bevat minimaal één en maximaal 100 adressen, en je kunt geldige IPv4- en IPv6-adressen in dezelfde lijst combineren. Het antwoord verpakt de geordende lookupresultaten in een results-array; elk resultaat gebruikt dezelfde vorm als lookup voor één IP, inclusief found en velden die null kunnen zijn.
Houd resultaten afgestemd op je brongegevens
Voor een geslaagde batch geeft de API één resultaat per invoeradres terug, in dezelfde volgorde. Houd je eigen recordidentificaties naast de ingediende lijst bij, zodat je de resultaten weer kunt koppelen aan je oorspronkelijke rijen. Wanneer een record niet wordt gevonden, behoud dan de rij en markeer de locatie als niet beschikbaar; wanneer alleen een veld ontbreekt, behoud dan de rest van het resultaat. Vervang ontbrekende coördinaten niet door nul, wat een afwezigheid van gegevens zou veranderen in een misleidende kaartlocatie.
Valideer voordat je verzendt
Een lege lijst, een lijst met meer dan 100 adressen, of een onjuist gevormd IP levert een verzoekfout op — een onjuist gevormd adres wijst de hele batch af in plaats van een gedeeltelijk succesvol resultaat voor de overige invoer te produceren. Valideer invoer en verdeel langere lijsten in batches voordat je ze verstuurt, en houd bij welke batches zijn voltooid, zodat een herhaalde poging niet per ongeluk een hele taak herhaalt.
Begrijp wat batchen verandert
Batchen vermindert het aantal HTTP-verzoeken dat nodig is om een lijst in te dienen. Het verandert niet de gegevensbron, voegt geen beveiligingsvelden toe en maakt van 100 lookups geen enkele gebruikseenheid — het lookupgebruik wordt per ingediend IP geregistreerd op geaccepteerde verzoeken, dus de abonnementskeuze moet zowel rekening houden met het totale lookupvolume als met de verzoeksnelheid. De rate limit per minuut telt HTTP-aanroepen, geen items: een batch van maximaal 100 IP's of e-mailadressen telt als één verzoek, terwijl elk item nog steeds apart meetelt voor de maandelijkse verzoeklimiet.
Vorm van verzoek en antwoord
- ips
- Verzoekbody: een JSON-array van 1 tot 100 IPv4- of IPv6-adressen.
- results
- Antwoord: een geordende array met één item per invoeradres, in de ingediende volgorde.
- results[].found, results[].country, ...
- Elk resultaat gebruikt dezelfde vorm en null-mogelijkheden als het antwoord voor lookup van één IP — zie de productpagina voor IP-lookup.
Stuur een batchverzoek
cURL — POST /v1/lookup
curl --fail-with-body \
'https://api.watch-ip.com/v1/lookup' \
--header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
--header 'Content-Type: application/json' \
--data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'Deze demonstratieadressen impliceren geen specifieke actuele locatiewaarden. Stel eerst WATCH_IP_SECRET_KEY in de omgeving van je server in.
Veelgestelde vragen
Hoeveel IP-adressen passen in een batch?
Het huidige maximum is 100. Splits langere lijsten op in verzoeken die elk 1 tot 100 adressen bevatten.
Kan een batch zowel IPv4 als IPv6 bevatten?
Ja. Elk adres moet geldig zijn, en de databasedekking kan per adres verschillen.
Worden resultaten in invoervolgorde teruggegeven?
Ja. Een geslaagde geaccepteerde batch geeft één resultaat per invoeradres terug, in dezelfde volgorde.
Wat gebeurt er als één IP onjuist is gevormd?
Het hele verzoek wordt afgewezen. Valideer je invoer voordat je deze indient — dit endpoint biedt geen gedeeltelijk succes voor onjuist gevormde invoer.
Wordt één batch als één lookup gefactureerd?
Nee. Het gebruik wordt per IP gemeten. Bekijk de huidige lookupprijzen en geverifieerde factureringsvoorbeelden voordat je de kosten van een grote taak inschat.
Kan ik een CSV-bestand uploaden?
Het gedocumenteerde endpoint accepteert een JSON-array van adressen. Je applicatie kan zijn eigen CSV lezen en batches indienen; een gehoste interface voor CSV-uploads maakt geen deel uit van deze API.
Bevat bulk lookup VPN- of Tor-controles?
Nee. Het huidige bulkantwoord is het locatieresultaat van de geolocatiedatabase van een externe partij. Beveiligingsindicatoren van bezoekersgeo zijn een aparte mogelijkheid die niet aanwezig is in lookupantwoorden.