Authentification

The ReportedIP API uses API key authentication to identify callers and apply rate limits. Some public endpoints work without authentication, but an API key unlocks higher rate limits and additional features. All endpoints, parameters and code examples are documented in the API Reference .

Authentification par API Key

Incluez votre API Key dans chaque requête authentifiée. Il existe deux méthodes : l’en-tête X-Key en-tête, car elle permet de ne pas faire apparaître votre clé dans les journaux d'accès au serveur.

Méthode 1 : en-tête X-Key (recommandée)

curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.com/wp-json/reportedip/v2/check?ip=1.2.3.4"

Méthode 2 : paramètre de requête

curl "https://reportedip.com/wp-json/reportedip/v2/check?ip=1.2.3.4&key=YOUR_API_KEY"

Obtenir votre API Key

Suivez ces trois étapes pour obtenir votre API Key :

Rôles et autorisations des utilisateurs

Votre API Key est liée à votre rôle d'utilisateur. Chaque rôle dispose de Rate Limits et d'un accès aux fonctionnalités différents. Vous commencez avec le rôle « Gratuit » lors de votre inscription.

Rate Limits

Chaque réponse de l’API inclut des en-têtes de Rate Limit afin que vous puissiez suivre votre utilisation en temps réel. Lorsque vous dépassez votre limite, l’API renvoie 429 Too Many Requests.

Exemple d'en-têtes de réponse

HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 742
X-RateLimit-Reset: 1711929600
Content-Type: application/json; charset=UTF-8

Authentification hybride

Endpoints publics tels que /check-public, /search-public, et /stats-public fonctionnent sans aucune authentification. Cependant, ils acceptent une API Key facultative permettant de débloquer des Rate Limits plus élevées.

# Without API key — 100 requests/day per IP
curl "https://reportedip.com/wp-json/reportedip/v2/check-public?ip=1.2.3.4"

# With API key — uses your role's daily limit
curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.com/wp-json/reportedip/v2/check-public?ip=1.2.3.4"

Réponses d'erreur

Les erreurs d’authentification renvoient des réponses JSON standard. Vérifiez toujours meta.success et le code d’état HTTP.

401 Non autorisé

Renvoyé lorsque la API Key est manquante ou non valide.

{
  "meta": {
    "success": false,
    "code": 401,
    "message": "Invalid or missing API key."
  },
  "data": null
}

403 Accès interdit

Renvoyé lorsque votre rôle ne dispose pas des autorisations nécessaires pour l'Endpoint demandé.

{
  "meta": {
    "success": false,
    "code": 403,
    "message": "Your role does not have access to this endpoint."
  },
  "data": null
}

429 Trop de requêtes

Renvoyé lorsque vous avez dépassé votre Rate Limit quotidienne.

{
  "meta": {
    "success": false,
    "code": 429,
    "message": "Rate limit exceeded. Try again later."
  },
  "data": {
    "retryAfter": 3600
  }
}

Bonnes pratiques

Dernière mise à jour :August 6, 2026 · Géré par l'équipe ReportedIP