Sur cette page

Documentation de l'API du panneau SMM

Version API : v2

SmmFoxi fournit une API de panneau SMM standard (v2) pour que vous intégriez 373 services de marketing sur les réseaux sociaux directement dans votre panneau revendeur, bot ou application. Démarrage rapide sur les services éligibles, tarifs compétitifs et automatisation complète. Cette documentation couvre tous les endpoints disponibles et leur utilisation.

Avant de commencer : accès à l'API en 4 étapes

Avant votre premier appel, il vous faut un compte, un solde approvisionné et une clé API. La configuration prend quelques minutes :

  1. 1

    Créez un compte

    Inscrivez-vous sur SmmFoxi. Le même compte sert au tableau de bord web et à l'API.

    S'inscrire →
  2. 2

    Rechargez votre solde

    Les commandes API sont débitées de votre solde. Ajoutez des fonds depuis le tableau de bord ; vous pouvez vérifier le solde à tout moment avec action=balance.

    Ouvrir le tableau de bord →
  3. 3

    Obtenez votre clé API

    Allez dans Tableau de bord → API et générez une clé. Elle n'est affichée en entier qu'une seule fois — copiez-la et conservez-la en lieu sûr. La régénérer désactive immédiatement l'ancienne.

    Obtenir la clé API →
  4. 4

    Intégrez et testez

    Envoyez des requêtes POST à l'adresse ci-dessous avec votre clé et une action. Commencez par action=services pour récupérer les ID et les prix des services, puis passez une petite commande de test.

    Voir l'adresse →

Endpoint API

https://smmfoxi.com/api/v2

Toutes les requêtes doivent être envoyées à cet endpoint via la méthode POST ou GET.

Authentification

Toutes les requêtes API nécessitent une authentification avec votre clé API. Générez-la dans Tableau de bord → API (la clé complète n'est affichée qu'une seule fois, enregistrez-la immédiatement). Incluez le paramètre key dans chaque requête.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Format de réponse

Toutes les réponses sont retournées au format JSON. Les requêtes réussies retournent les données demandées, tandis que les erreurs retournent un objet avec une description.

Endpoints API

Obtenir les services

Retourne une liste de tous les services disponibles avec leurs détails incluant les prix, quantités minimales et maximales.

Paramètres

  • key - Votre clé API (obligatoire)
  • action - "services"
// Exemple de réponse
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Obtenir le solde

Retourne le solde actuel de votre compte et la devise.

Paramètres

  • key - Votre clé API (obligatoire)
  • action - "balance"
// Exemple de réponse
{
  "balance": "100.84292",
  "currency": "USD"
}

Ajouter une commande

Créer une nouvelle commande pour un service. Les paramètres requis dépendent du type de service.

Type par défaut

  • key - Votre clé API (obligatoire)
  • action - "add"
  • service - ID du service (obligatoire)
  • link - URL cible (obligatoire)
  • quantity - Quantité de la commande (obligatoire)

Type forfait

  • key - Votre clé API (obligatoire)
  • action - "add"
  • service - ID du service (obligatoire)
  • link - URL cible (obligatoire)

Type commentaires personnalisés

  • key - Votre clé API (obligatoire)
  • action - "add"
  • service - ID du service (obligatoire)
  • link - URL cible (obligatoire)
  • comments - Commentaires séparés par des sauts de ligne (obligatoire)
// Exemple de réponse
{
  "order": 23501
}

Statut de commande

Obtenir le statut d'une ou plusieurs commandes. Vous pouvez interroger une seule commande ou plusieurs à la fois.

Commande unique

  • key - Votre clé API (obligatoire)
  • action - "status"
  • order - ID de la commande (obligatoire)

Commandes multiples (jusqu'à 100)

  • key - Votre clé API (obligatoire)
  • action - "status"
  • orders - IDs des commandes séparés par des virgules (obligatoire)
// Exemple de réponse
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Créer un réapprovisionnement

Demander un réapprovisionnement pour une commande. Disponible uniquement pour les services supportant les réapprovisionnements.

Paramètres

  • key - Votre clé API (obligatoire)
  • action - "refill"
  • order - ID de la commande (obligatoire)
// Exemple de réponse
{
  "refill": "1"
}

Statut du réapprovisionnement

Vérifier le statut d'une demande de réapprovisionnement.

Paramètres

  • key - Votre clé API (obligatoire)
  • action - "refill_status"
  • refill - ID du réapprovisionnement (obligatoire)
// Exemple de réponse
{
  "status": "Completed"
}

Statuts des commandes

  • Pending - La commande est en attente de traitement
  • Processing - La commande est en préparation
  • In progress - La commande est en cours d'exécution
  • Completed - La commande a été complétée avec succès
  • Partial - La commande a été partiellement complétée (remboursement pour le reste)
  • Canceled - La commande a été annulée

Gestion des erreurs

Lorsqu'une erreur survient, l'API retourne un objet JSON avec un champ error décrivant le problème.

// Exemple de réponse d'erreur
{
  "error": "Invalid API key"
}

Limites de taux

Pour assurer la qualité du service, les limites de taux suivantes s'appliquent :

  • 5 requêtes par seconde
  • 100 requêtes par minute
  • 1000 requêtes par heure