Référence API

Bientôt disponible — L’API REST publique est actuellement sur notre feuille de route et n’est pas encore disponible. La documentation ci-dessous décrit la conception prévue de l’API. Nous annoncerons sa disponibilité sur notre changelog.

L’API REST PostClaw vous permettra de gérer les publications, les plateformes, les automatisations et la génération IA par programme.

URL de base : https://app.postclaw.fun/v1

Authentification

Toutes les requêtes nécessitent un token Bearer. Générez des clés API sous Paramètres → Clés API.

curl https://app.postclaw.fun/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

Les clés sont à portée définie : read, write ou admin. Utilisez la portée minimale nécessaire.

Limites de débit

Les en-têtes de limite de débit sont retournés dans chaque réponse :

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1743484800

Endpoints

Publications

# Lister les publications
GET /v1/posts?status=scheduled&limit=20

# Créer une publication
POST /v1/posts
{
  "content": "Your caption here",
  "platforms": ["twitter", "linkedin"],
  "scheduled_at": "2026-04-01T09:00:00Z",
  "media_ids": ["media_abc123"]
}

# Récupérer une publication
GET /v1/posts/{id}

# Annuler une publication planifiée
DELETE /v1/posts/{id}

Médias

# Téléverser un média
POST /v1/media
Content-Type: multipart/form-data
# Retourne : { "id": "media_abc123", "url": "...", "type": "image" }

# Lister la médiathèque
GET /v1/media?type=image&limit=50

Plateformes

# Lister les comptes connectés
GET /v1/platforms

# Déconnecter un compte
DELETE /v1/platforms/{id}

Génération IA

# Générer du texte de publication
POST /v1/ai/text
{
  "prompt": "Announce our new feature: dark mode",
  "platform": "twitter",
  "tone": "casual"
}

# Générer une image
POST /v1/ai/image
{
  "prompt": "Clean minimal desk setup, natural light",
  "size": "1024x1024"
}

Automatisations

# Lister les automatisations
GET /v1/automations

# Déclencher une automatisation manuellement
POST /v1/automations/{id}/trigger
{ "input": "https://example.com/article" }

Webhooks

Enregistrez une URL pour recevoir des événements :

POST /v1/webhooks
{
  "url": "https://yoursite.com/postclaw-events",
  "events": ["post.published", "post.failed", "automation.completed"]
}

Structure du payload d’événement :

{
  "event": "post.published",
  "timestamp": "2026-04-01T09:00:05Z",
  "data": {
    "post_id": "post_xyz789",
    "platform": "twitter",
    "url": "https://twitter.com/user/status/..."
  }
}

Réponses d’erreur

Toutes les erreurs suivent un format cohérent :

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Retry after 60 seconds.",
    "retry_after": 60
  }
}

Codes d’erreur courants : unauthorized, forbidden, not_found, validation_error, rate_limit_exceeded, platform_error.

SDKs

Les SDKs officiels sont en cours de développement. En attendant, utilisez n’importe quel client HTTP. L’API est entièrement documentée sur app.postclaw.fun/docs (spécification OpenAPI 3.1 disponible en téléchargement).