Documentation de l'API

HstockPlus/Documentation de l'API

Votre Clé API

Chargement...

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.

Clé API

Langue (optionnelle)

Action

Demander une commande

Se met à jour automatiquement lorsque vous modifiez l'action ou les paramètres.

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

Point de terminaison API

https://hstockplus.com/api/v2

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

IMPORTANT — URLs des images produit (imageUrl)

Lorsque Media CDN est activé, les champs `imageUrl` dans les réponses des listes de services, de produits et des informations de sous-catégorie utilisent le domaine CDN (https://cdn.hstockplus.org/...). Utilisez directement ces URL absolues dans votre application — ne les remplacez pas par hstockplus.com ou hstockplus.net.

https://cdn.hstockplus.org/uploads/products/gmail.webp

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.

Codes de langue pris en charge

zhesfrdejakoptpt-BRruarhiviurbn-BDen(défaut — omettez lang ou utilisez en)

Utilisez ces valeurs exactes pour le paramètre lang. Alias : jp est accepté comme ja.

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.

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.	No

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.

Parameter	Description	Required
key	Your API key	Yes
action	subcategory_info	Yes
subcategoryId	Subcategory ID from Products List	Yes
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.	No

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://cdn.hstockplus.org/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é.

Parameter	Description	Required
key	Your API key	Yes
action	shops	Yes
page	Page number (default 1).	No
limit	Items per page (default 20).	No

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 de la marketplace (pas de services SMM). Mêmes champs que les lignes de produits dans la liste des services, y compris id (identifiant d'entité produit), service (numéro de service convivial), description et imageUrl. productIds (facultatif) 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 en tableau JSON, max 100). sort=sold (facultatif) trie les résultats par unités de commande payées décroissantes (meilleures ventes en premier).

Parameter	Description	Required
key	Your API key	Yes
action	products	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only products in this category.	No
subcategory	Filter by subcategory name (from Get Categories). Returns only products in this subcategory.	No
shopId	Filter by shop ID (from Shops List). Returns only that shop's products.	No
productIds	Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	No
isRecommended	Optionnel. Définissez true pour ne renvoyer que les produits avec isRecommended === true.	No
sort	Facultatif. sold = trier par unités commandées payées en ordre décroissant (meilleurs ventes en premier). Omettre pour conserver l'ordre par défaut du cache.	No
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.	No

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"

Meilleures ventes dans une sous-catégorie :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

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 comprend l'id (identifiant de l'entité), le service (numéro de service convivial), le stock et le type d'entité (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 issues de l'API Get Categories). Le paramètre optionnel shopId ne renvoie que les produits et services de cette boutique (utilisez shopId depuis la liste des boutiques). Le paramètre optionnel productIds ne renvoie que les lignes correspondantes (numéros de service conviviaux et/ou identifiants d'entité ; correspond aux lignes product ou smm). Utilisez action=products pour filtrer uniquement les produits.

Parameter	Description	Required
key	Your API key	Yes
action	services	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only services in this category.	No
subcategory	Filter by subcategory name (from Get Categories). Returns only services in this subcategory.	No
shopId	Filter by shop ID (from Shops List). Returns only that shop's products and SMM services.	No
entityType	Filtre optionnel : product ou smm. Renvoie uniquement les produits de la place de marché ou uniquement les services SMM.	No
productIds	Optional list of IDs (friendly service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns matching product or smm rows. Use action=products for products only.	No
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.	No

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://cdn.hstockplus.org/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).

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.	No

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.

Ajouter une commande

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.

Parameter	Description	Required
key	Your API key	Yes
action	add	Yes
service	Service ID	Yes
link	Link: For SMM orders (e.g. followers, likes, comments): required — URL or link to the content (e.g. Instagram post URL). For product orders (e.g. accounts): optional — delivery email or reference; if empty, the system uses your account email.	No
quantity	Quantity to order	Yes

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.

Parameter	Description
key	Your API key
action	status
order	Order ID

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 :

PendingIn progressCompletedPartialCanceled

Annuler

Annuler une ou plusieurs commandes (format batch compatible PerfectPanel). Chaque commande éligible est remboursée sur votre solde.

Toutes les conditions suivantes doivent être remplies. Utilisez allowcancel pour vérifier l'éligibilité sans effectuer de remboursement.

Annulation anticipée : fonctionnalité de la plateforme activée (paramètre administrateur).
Annulation anticipée : le type de produit est auto ou inventaire (les services SMM automatiques utilisent généralement le type de produit auto).
Annulation anticipée : le statut du paiement est terminé ou partiel.
Annulation anticipée : le statut de la commande est en attente, en cours de traitement ou en erreur (les erreurs du fournisseur apparaissent comme en cours).
Annulation anticipée : pas de external_id (commande non encore envoyée à un fournisseur ou prestataire externe).
Annulation anticipée : au moins N minutes depuis la fin du paiement (auto_order_early_refund_minutes, par défaut 30).
Annulation anticipée : le client n'a pas déjà utilisé le remboursement anticipé automatique sur cette commande.
Annulation anticipée : la commande n'est pas entièrement livrée (une livraison partielle donne lieu à un remboursement proportionnel pour la partie non livrée).
Annulation anticipée : un montant remboursable reste disponible (le montant remboursé est inférieur au total de la commande).
Annulation anticipée : aucun litige actif sur la commande.
Annulation anticipée : aucun retrait du fournisseur en statut demandé ou terminé.

Une livraison partielle donne lieu à un remboursement partiel proportionnel ; les comptes livrés sont conservés.

Parameter	Description
key	Your API key
action	cancel
orders	IDs de commande (séparés par une virgule, jusqu'à 100 IDs)

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

Exemple de réponse :

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

Autoriser l'annulation

Vérifiez si une ou plusieurs commandes peuvent être annulées immédiatement (mêmes règles d'éligibilité que pour l'annulation, mais aucun remboursement n'est traité). Utilisez cette fonction avant d'appeler l'annulation pour éviter des requêtes échouées. Prend en charge les identifiants de commandes groupés (séparés par des virgules, jusqu'à 100).

Toutes les conditions suivantes doivent être remplies. Utilisez allowcancel pour vérifier l'éligibilité sans effectuer de remboursement.

Annulation anticipée : fonctionnalité de la plateforme activée (paramètre administrateur).
Annulation anticipée : le type de produit est auto ou inventaire (les services SMM automatiques utilisent généralement le type de produit auto).
Annulation anticipée : le statut du paiement est terminé ou partiel.
Annulation anticipée : le statut de la commande est en attente, en cours de traitement ou en erreur (les erreurs du fournisseur apparaissent comme en cours).
Annulation anticipée : pas de external_id (commande non encore envoyée à un fournisseur ou prestataire externe).
Annulation anticipée : au moins N minutes depuis la fin du paiement (auto_order_early_refund_minutes, par défaut 30).
Annulation anticipée : le client n'a pas déjà utilisé le remboursement anticipé automatique sur cette commande.
Annulation anticipée : la commande n'est pas entièrement livrée (une livraison partielle donne lieu à un remboursement proportionnel pour la partie non livrée).
Annulation anticipée : un montant remboursable reste disponible (le montant remboursé est inférieur au total de la commande).
Annulation anticipée : aucun litige actif sur la commande.
Annulation anticipée : aucun retrait du fournisseur en statut demandé ou terminé.

Lorsque allowcancel est à 1, la réponse inclut refundAmount (le montant que l'annulation rembourserait).

Parameter	Description
key	Your API key
action	allowcancel
orders	IDs de commande (séparés par une virgule, jusqu'à 100 IDs)

Exemple de demande :

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

Exemple de réponse :

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

Solde

Obtenez votre solde actuel.

Parameter	Description
key	Your API key
action	balance

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.

1. Obtenez des projets SMS

Action: sms_projects

Parameter	Description
key	Your API key
action	sms_projects
country	Optional. Filter by country ID (e.g. 'us', 'gb')
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.

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

2. Obtenir des pays SMS

Action: sms_countries

Parameter	Description
key	Your API key
action	sms_countries
lang	Code de langue optionnel. Voir les codes pris en charge dans Langue optionnelle (lang) ci-dessus.

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

3. Créer une commande SMS

Action: add_sms

Parameter	Description	Required
key	Your API key
action	add_sms
project_id	Project ID from sms_projects	Yes
quantity	Number of numbers (1-10)	No (Default 1)
country	Country code (e.g. 'us')	No
phone	Phone number to reuse	No

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

4. Obtenir le code SMS

Action: sms_code

Parameter	Description
key	Your API key
action	sms_code
order	Order ID

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

5. Statut de la commande par SMS

Action: sms_status

Parameter	Description
key	Your API key
action	sms_status
order	Order ID

{
  "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.

{"error": "Invalid API key"}

{"error": "Invalid action"}

{"error": "Service ID is required"}

{"error": "Insufficient balance"}

{"error": "Order not found"}

{"error": "Service not found"}

Besoin d'aide ? Contactez-nous à support@hstockplus.com

Votre Clé API

Tester l'API

Point de terminaison API

Langue optionnelle (lang)

Obtenir les Catégories

Exemple de demande :

Exemple de réponse :

Infos de la sous-catégorie

Exemple de demande :

Exemple de réponse :

Liste des Boutiques

Exemple de demande :

Liste des Produits

Exemple de demande :

Liste des services

Exemple de demande :

Exemple de réponse :

Vérifier l'Inventaire

Exemple de demande :

Exemple de réponse (SMM) :

Exemple de réponse (produit) :

Ajouter une commande

Exemple de demande :

Exemple de réponse :

Statut de la commande

Exemple de demande :

Exemple de réponse :

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

Statuts possibles :

Annuler

Exemple de demande :

Exemple de réponse :

Autoriser l'annulation

Exemple de demande :

Exemple de réponse :

Solde

Exemple de demande :

Exemple de réponse :

SMS Verification API

1. Obtenez des projets SMS

2. Obtenir des pays SMS

3. Créer une commande SMS

4. Obtenir le code SMS

5. Statut de la commande par SMS

Réponses d'erreur

Méthodes de paiement acceptées