Ihr API-Schlüssel

Test API

Wähle eine Aktion aus, fülle die Parameter aus und sende eine Anfrage. Wenn du eingeloggt bist, wird dein API-Schlüssel automatisch geladen.

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

API-Endpunkt

Alle API-Anfragen sollten über HTTP POST an diesen Endpunkt gesendet werden.

Deutsch

Optional. Zielsprachencode. Verwenden Sie einen der unten aufgeführten unterstützten Codes. Wenn gesetzt und nicht en, werden übersetzbare Felder in dieser Sprache zurückgegeben. Falls eine Übersetzung noch nicht verfügbar ist, gibt die API Englisch zurück.

Unterstützt bei Leseaktionen: categories, services, products, inventory ((Unterproduktnamen)), sms_projects, und sms_countries. Verwende "lang" nicht oder nutze "en" für Englisch.

Die Filterparameter für Kategorien und Unterkategorien bei Dienstleistungen/Produkten verwenden immer die kanonischen englischen Bezeichnungen, selbst wenn die Sprache (lang) festgelegt ist.

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

Kategorien abrufen

Rufe alle Kategorien und deren Unterkategorien ab. Verwende diese Werte, um die Dienstleistungsliste nach Kategorie oder Unterkategorie zu filtern.

Beispielanfrage:

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

Beispielantwort:

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

Geschäfte-Liste

Liste der aktiven Shops mit grundlegenden Informationen, Produktanzahl und Bewertungen. Die Shop-Namen sind aus Datenschutzgründen anonymisiert.

Beispielanfrage:

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

Mit Paginierung:

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

Produktliste

Liste nur Marktplatzprodukte auf (keine SMM-Dienste). Gleiche Felder wie Produktzeilen in der Dienstleistungsliste, einschließlich ID (MongoDB-Produkt-ID), Dienst (benutzerfreundliche Dienstnummer), Beschreibung und imageUrl. Optionales productIds gibt nur diese Produkte zurück (benutzerfreundliche Dienstnummern aus der Liste und/oder MongoDB-Produkt-IDs, kommagetrennt oder als JSON-Array, max. 100).

Beispielanfrage:

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

Nach Produkt-IDs filtern:

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

Mit Paginierung:

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

Nach Kategorie oder Unterkategorie filtern:

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"

Dienstliste

Holen Sie alle verfügbaren Dienste mit optionaler Paginierung ab. Jede Zeile enthält die ID (MongoDB-Entitäts-ID), den Dienst (freundliche Dienstnummer), den Bestand und den Entitätstyp (smm oder product). Der optionale Parameter entityType gibt nur Produkt- oder nur SMM-Zeilen zurück. Die optionalen Parameter category und subcategory geben nur Dienste in dieser Kategorie oder Unterkategorie zurück (Werte aus der Get Categories API). Der optionale Parameter shopId gibt nur Produkte und Dienste für diesen Shop zurück (verwenden Sie die shopId aus der Shops-Liste). Der optionale Parameter productIds gibt nur passende Marktplatzprodukte zurück (SMM-Dienste werden ausgelassen, wenn productIds gesetzt ist).

Beispielanfrage:

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

Mit Paginierung:

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

Nach Kategorie oder Unterkategorie filtern:

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"

Nach Entitätstyp filtern:

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

Beispielantwort:

{
  "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"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Jede Zeile enthält id (MongoDB-Entitäts-ID) und service (benutzerfreundliche Servicenummer für Bestellungen), stock, entityType (smm oder product) sowie autoDelivery. Produktzeilen enthalten zusätzlich description und imageUrl. Wenn limit 0 ist oder ausgelassen wird, werden alle Dienste zurückgegeben und page/limit entsprechen der Gesamtanzahl.

Inventar prüfen

Rufen Sie den aktuellen Bestand und die Verfügbarkeit für einen Dienst anhand seiner ID ab (dieselbe ID wie in der Dienstliste). Bei Marktplatzprodukten enthält das JSON Unterprodukte: ein Array aktiver Varianten, jeweils mit subproductId, Name und Bestand (angezeigter Bestand für diese Variante).

Beispielanfrage:

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

Beispielantwort (SMM):

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

Beispielantwort (Produkt):

{
  "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 }
  ]
}

Die Antwort enthält den Preis (pro Einheit, gleiches Zeichenfolgenformat wie die Dienstleistungsliste), den Entitätstyp (smm oder product) und autoDelivery (true = automatische Lieferung, false = Lieferant erfüllt manuell). Bei Produktdienstleistungen stimmen min und max mit der primären Unterproduktzeile in der Dienstleistungsliste überein; falls dieses Unterprodukt Ihre Bestellung nicht erfüllen kann, kann die Plattform ein anderes Unterprodukt auswählen und dessen Einheitspreis berechnen. Das Unterprodukt-Array listet jede aktive Variante mit Anzeigebestand auf; SMM-Bestandsantworten enthalten keine Unterprodukte.

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.

Beispielanfrage:

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"

Beispielantwort:

{
  "order": 23501
}

Bestellstatus

Den Status einer Bestellung abrufen.

Beispielanfrage:

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

Beispielantwort:

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

Bei Produktbestellungen (z.B. Konten) enthält die Antwort, wenn die Bestellung vollständig oder teilweise ausgeliefert wurde, ein "accounts"-Array mit den Zugangsdaten der gelieferten Konten (ein String pro Konto). Bei Teillieferung werden nur die bisher gelieferten Konten zurückgegeben.

autoDelivery: true, wenn die Bestellung automatisch ausgeführt wird (z. B. SMM, Auto-/Bestandsprodukte); false, wenn der Lieferant manuell ausführen muss (kann einige Zeit in Anspruch nehmen).

Beispielantwort (Produktbestellung mit gelieferten Konten):

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

Mögliche Status:

Kontostand

Holen Sie sich Ihr aktuelles Guthaben.

Beispielanfrage:

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

Beispielantwort:

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

SMS Verification API

Dedizierte Endpunkte für SMS-Verifizierungsdienste.

[
  {
    "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"
}

Fehlerantworten

Häufige Fehlermeldungen, auf die Sie stoßen könnten.