Référence API

Documentation de l'API publique rpicx

Informations de base

Adresse par défaut	`https://api.rpicx.com/v1`
Format de données	JSON
OpenAPI	`GET /openapi.json`

Liste des endpoints

`GET /v1/health`

Authentification : Aucune

Fonction : Vérification de santé du service, retourne le nombre total d'images et l'état de fonctionnement.

Réponse 200 :

{
  "status": "ok",
  "image_count": 100000
}

`GET /v1/random`

Authentification : Aucune

Fonction : Sélectionne aléatoirement une image et retourne une redirection 302.

Paramètres de requête :

Paramètre	Type	Required	Description
`category`	string	No	Filter by category

Succès (302) :

Location: https://img.rpicx.com/xxx.webp

Aucune image (404) :

{ "success": false, "error": "No images available" }

`GET /v1/categories`

Authentification : Aucune

Fonction : Retourne le nombre total d'images.

Réponse 200 :

{
  "total_images": 100000,
  "categories": []
}

`GET /v1/stats`

Authentification : Aucune (Limite IP 10 QPS, cache réponse 3h)

Fonction : Retourne les statistiques agrégées du service.

Réponse 200 :

{
  "requests_total": 1000000,
  "requests_today": 5000,
  "avg_hour_requests": 200.0,
  "uv_today": 1200,
  "top_referer": [{ "name": "github.com", "count": 300 }],
  "top_ua": [{ "name": "Chrome", "count": 500 }],
  "status": { "code_200": 900000, "code_302": 50000, "code_404": 20, "code_429": 10, "code_500": 0 },
  "sync_count": 30
}

`GET /metrics`

Authentification : Aucune

Fonction : Point de terminaison des métriques Prometheus (text/plain).

`GET /openapi.json`

Authentification : Aucune

Fonction : Retourne le document de spécification OpenAPI 3.0 (JSON).