Premiers pas
Erreurs
Les erreurs arrivent en JSON avec un code stable à tester.
Format des erreurs
- errorstring
Code d'erreur stable à tester.
- messagestring
Explication lisible.
- detailsobject
Seulement sur les 400 en masse : les entrées invalides.
{
"error": "invalid_ip",
"message": "Invalid IP address format"
}Codes de statut
- 400bad_request, invalid_ip, reserved_ip, invalid_domain, invalid_target, unresolved_host, unknown_jurisdiction, invalid_asn
La requête ou une entrée n'est pas valide.
- 401missing_api_key, invalid_api_key, unauthorized
La clé API manque ou est inconnue.
- 403account_suspended
Le compte est suspendu.
- 404not_found
Rien n'existe à ce chemin ou pour cet id.
- 413too_many_lines
Le corps ou la liste est trop volumineux.
- 429rate_limit_exceeded
Une limite de débit est épuisée.
- 500server_error
Une erreur s'est produite chez nous ; réessayez plus tard.
Erreurs dans les SDK
- APIError
Toute réponse d'erreur, avec status, code et message.
- AuthenticationError
401 ou 403.
- NotFoundError
404.
- RateLimitError
429, avec reason, retryAfter et un lien de mise à niveau.
- ConnectionError
Aucune réponse reçue, y compris en cas de timeout.
import IPScanner, { APIError, RateLimitError } from '@ipscanner.io/sdk';
const client = new IPScanner({ apiKey: 'YOUR_API_KEY' });
try {
await client.ip.lookup('8.8.8.8');
} catch (err) {
if (err instanceof RateLimitError) {
console.log(err.reason, err.retryAfter, err.upgradeUrl);
} else if (err instanceof APIError) {
console.log(err.status, err.code, err.message);
} else {
throw err;
}
}