Skip to main content

​
API Vinkit

L’API Vinkit vous permet de gérer votre blog par programmation : créer des articles, gérer les tags, récupérer vos contenus et recevoir des notifications via webhooks.

​
URL de base

https://api.vinkit.co/v1

​
Authentification

Toutes les requêtes API nécessitent un token Bearer. Générez votre clé API depuis Paramètres > API dans votre tableau de bord. 
curl -H "Authorization: Bearer VOTRE_CLE_API" \
  https://api.vinkit.co/v1/posts
Ne partagez jamais votre clé API. Si elle est compromise, régénérez-la immédiatement depuis votre tableau de bord.

​
Format des réponses

L’API retourne des réponses au format JSON. Les erreurs suivent ce format : 
{
  "error": 400,
  "message": "Description de l'erreur"
}

​
Codes de statut

CodeDescription
200Succès
201Ressource créée
204Suppression réussie
400Requête invalide
401Non authentifié
404Ressource non trouvée
429Trop de requêtes (rate limit)

​
Rate limiting

L’API est limitée à 100 requêtes par minute par clé API. Les en-têtes de réponse incluent :
  • X-RateLimit-Limit — nombre maximum de requêtes
  • X-RateLimit-Remaining — requêtes restantes
  • X-RateLimit-Reset — timestamp de réinitialisation

Spécification OpenAPI

Consultez la spécification OpenAPI complète