Passer au contenu principal
Tous les points de terminaison de l’API Claw nécessitent une authentification via l’en-tête Authorization: Bearer sk-.... URL de base : https://api.lemondata.cc/v1/claw

​
Lister les instances

GET /v1/claw/instances
Retourne toutes les instances pour l’organisation authentifiée. 
curl https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key"

{
  "instances": [
    {
      "id": "cm5abc123",
      "subdomain": "mybot",
      "url": "https://claw-mybot.lemondata.cc",
      "defaultModel": "claude-opus-4-6",
      "hasIMConfig": true,
      "status": "RUNNING",
      "paidUntil": "2026-03-10T00:00:00.000Z",
      "canRebuild": true,
      "totalPaid": 20,
      "createdAt": "2026-02-08T00:00:00.000Z"
    }
  ]
}

​
Valeurs de statut de l’instance

StatutDescription
PENDINGNouvellement créée, en attente de provisionnement
PROVISIONINGLe conteneur est en cours de déploiement
RUNNINGL’instance est active et saine
STOPPEDArrêtée pour cause d’expiration (données conservées 7 jours)
FAILEDÉchec du déploiement (remboursement automatique)
DELETEDSupprimée définitivement

​
Créer une instance

POST /v1/claw/instances
Crée une nouvelle instance et facture 20 $ pour 30 jours sur le solde de votre organisation.
​
subdomain
string
requis
Sous-domaine (3-32 caractères, alphanumérique en minuscules + traits d’union). URL de l’instance : https://claw-{subdomain}.lemondata.cc
​
defaultModel
string
Modèle d’IA par défaut (ex. : claude-opus-4-6, gpt-5.2, gemini-3-pro-preview, minimax-m2.5, kimi-k2.5)
curl -X POST https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"subdomain": "mybot", "defaultModel": "claude-opus-4-6"}'

{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "url": "https://claw-mybot.lemondata.cc",
  "status": "PENDING",
  "paidUntil": "2026-03-10T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}
Un solde insuffisant retourne 402 Payment Required. Assurez-vous que votre organisation dispose d’au moins 20 $ avant de créer une instance.

​
Obtenir une instance

GET /v1/claw/instances/:id
Retourne les détails d’une instance spécifique.

​
Mettre à jour une instance

PATCH /v1/claw/instances/:id
Mettre à jour la configuration de l’instance.
​
defaultModel
string | null
Changer le modèle d’IA par défaut
​
imConfig
object | null
Mettre à jour la configuration de la plateforme de messagerie instantanée (Telegram, Discord, etc.)
curl -X PATCH https://api.lemondata.cc/v1/claw/instances/cm5abc123 \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"defaultModel": "claude-sonnet-4-5"}'

​
Reconstruire une instance

POST /v1/claw/instances/:id/rebuild
Détruit et recrée le conteneur tout en préservant les données (PVC). Limité à 10 reconstructions par jour. Retourne 429 Too Many Requests si la limite quotidienne est dépassée.

​
Renouveler une instance

POST /v1/claw/instances/:id/renew
Prolonge la période de facturation de 30 jours (20 $). Si l’instance a été arrêtée pour cause d’expiration, elle redémarrera automatiquement. 
{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "status": "RUNNING",
  "paidUntil": "2026-04-09T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}

​
Vérification de l’état (Health Check)

GET /v1/claw/health
Retourne l’état de santé du service Claw. Aucune authentification requise. 
{"status": "ok", "timestamp": "2026-02-08T15:00:00.000Z"}