Votre Clé API

Tester l'API

Sélectionnez une action, remplissez les paramètres et envoyez une requête. Lorsque vous êtes connecté, votre clé API est chargée automatiquement.

curl -X POST "https://hstockplus.com/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

Point de terminaison API

Toutes les requêtes API doivent être envoyées via HTTP POST à ce point de terminaison.

Langue optionnelle (lang)

Optionnel. Code de langue cible. Utilisez l'un des codes pris en charge listés ci-dessous. Lorsqu'il est défini et différent de en, les champs traduisibles sont renvoyés dans cette langue. Si une traduction n'est pas encore disponible, l'API renvoie l'anglais.

Pris en charge sur les actions de lecture : categories, subcategory_info, services, products, inventory ((noms des sous-produits)), sms_projects, et sms_countries. Omettez lang ou utilisez en pour l'anglais.

Les paramètres de filtre catégorie et sous-catégorie sur les services/produits utilisent toujours les noms canoniques en anglais, même lorsque lang est défini.

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Obtenir les Catégories

Obtenez toutes les catégories et les sous-catégories de chaque catégorie. Utilisez ces valeurs pour filtrer la Liste des Services par catégorie ou sous-catégorie.

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

Exemple de réponse :

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

Infos de la sous-catégorie

Obtenez les détails d'une sous-catégorie par subcategoryId, y compris la catégorie parente. Utilisez subcategoryId des lignes Products List.

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

Exemple de réponse :

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://example.com/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

Liste des Boutiques

Liste les boutiques actives avec les informations de base, le nombre de produits et les évaluations. Les noms des boutiques sont masqués pour la confidentialité.

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

Avec pagination :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

Liste des Produits

Listez uniquement les produits marketplace (pas de services SMM). Mêmes champs que les lignes product dans Services List, y compris id (identifiant de l'entité produit), service (numéro de service convivial), description et imageUrl. Le paramètre optionnel productIds ne renvoie que ces produits (numéros de service conviviaux de la liste et/ou identifiants d'entité produit, séparés par des virgules ou tableau JSON, max 100).

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

Filtrer par identifiants de produits :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

Avec pagination :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

Filtrer par catégorie ou sous-catégorie :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

Produits recommandés uniquement :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

Liste des services

Obtenez tous les services disponibles avec pagination optionnelle. Chaque ligne inclut id (identifiant de l'entité), service (numéro de service convivial), stock et entityType (smm ou product). Le paramètre optionnel entityType ne renvoie que les lignes product ou smm. Les paramètres optionnels category et subcategory ne renvoient que les services de cette catégorie ou sous-catégorie (valeurs de l'API Get Categories). Le paramètre optionnel shopId ne renvoie que les produits et services de cette boutique (utilisez shopId de Shops List). Le paramètre optionnel productIds ne renvoie que les produits marketplace correspondants (les services SMM sont omis lorsque productIds est défini).

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Avec pagination :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

Filtrer par catégorie ou sous-catégorie :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Filtrer par type d'entité :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

Exemple de réponse :

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://example.com/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Chaque ligne inclut id (identifiant de l'entité) et service (numéro de service convivial pour les commandes), stock, entityType (smm ou product) et autoDelivery. Les lignes product incluent également description, imageUrl, isRecommended et subcategoryId. Lorsque limit est 0 ou omis, tous les services sont renvoyés et page/limit égalent le total.

Vérifier l'Inventaire

Obtenez le stock et la disponibilité actuels d’un service par son ID (même ID que dans la liste des services). Pour les produits de la marketplace, le JSON inclut des sous-produits : un tableau de variantes actives, chacune avec subproductId, name et stock (stock affiché pour cette variante).

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

Exemple de réponse (SMM) :

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

Exemple de réponse (produit) :

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0 }
  ]
}

La réponse inclut le tarif (par unité, même format de chaîne que la liste des services), le type d’entité (smm ou product), et la livraison automatique (true = livraison automatique, false = le fournisseur exécute manuellement). Pour les services de type produit, les valeurs min et max correspondent à la sous‑ligne principale de la liste des services ; si cette sous‑ligne ne peut pas exécuter votre commande supplémentaire, la plateforme peut sélectionner une autre sous‑ligne et facturer son prix unitaire. Le tableau subproducts liste chaque variante active avec le stock affiché ; les réponses d’inventaire SMM omettent les sous‑produits.

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery.

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

Exemple de réponse :

{
  "order": 23501
}

Statut de la commande

Obtenir le statut d'une commande.

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

Exemple de réponse :

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

Pour les commandes de produits (ex. comptes), lorsque la commande est livrée en totalité ou partiellement, la réponse inclut un tableau "accounts" avec les identifiants des comptes livrés (une chaîne de caractères par compte). Pour une livraison partielle, seuls les comptes livrés jusqu'à présent sont renvoyés.

autoDelivery : true si la commande est exécutée automatiquement (par exemple, SMM, produits auto/inventaire) ; false si le fournisseur doit exécuter manuellement (peut prendre du temps).

Exemple de Réponse (commande de produit avec comptes livrés) :

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

Statuts possibles :

Solde

Obtenez votre solde actuel.

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

Exemple de réponse :

{
  "balance": "100.00",
  "currency": "USD"
}

SMS Verification API

Points de terminaison dédiés pour les services de vérification par SMS.

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

[
  {
    "country_code": "us",
    "country_name": "United States"
  },
  {
    "country_code": "gb",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}

{
  "status": "code_received",
  "phone": "+1234567890",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "expires_at": "2023-01-01T12:00:00.000Z"
}

Réponses d'erreur

Réponses d'erreur courantes que vous pouvez rencontrer.