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, subcategory_info, 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"]
    }
  ]
}

Unterkategorie-Informationen

Rufen Sie die Details der Unterkategorie anhand der subcategoryId ab, einschließlich der übergeordneten Kategorie. Verwenden Sie die subcategoryId aus den Zeilen der Produktliste.

Beispielanfrage:

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

Beispielantwort:

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

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

Listen Sie nur Marktplatzprodukte auf (keine SMM-Dienste). Gleiche Felder wie bei Produktzeilen in der Dienstliste, einschließlich ID (Produktentitäts-ID), Dienst (freundliche Dienstnummer), Beschreibung und imageUrl. Optionales productIds gibt nur diese Produkte zurück (freundliche Dienstnummern aus der Liste und/oder Produktentitäts-IDs, kommagetrennt oder 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"

Nur empfohlene Produkte:

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

Dienstleistungsliste

Rufen Sie alle verfügbaren Dienste mit optionaler Paginierung ab. Jede Zeile enthält id (Entitäts-ID), service (benutzerfreundliche Dienstnummer), stock und entityType (smm oder product). Optionales entityType gibt nur product- oder nur smm-Zeilen zurück. Optionale Parameter category und subcategory geben nur Dienste in dieser Kategorie oder Unterkategorie zurück (Werte aus der Get Categories API). Optionales shopId gibt nur Produkte und Dienste für diesen Shop zurück (verwenden Sie shopId aus der Shops List). Optionales productIds gibt nur übereinstimmende 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",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

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

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:

Stornierung erstellen

Einen oder mehrere Aufträge stornieren (PerfectPanel-kompatibles Batch-Format). Jeder berechtigte Auftrag wird dir auf dein Guthaben erstattet.

Alle folgenden Punkte müssen zutreffen. Verwende allowcancel, um die Berechtigung zu prüfen, ohne eine Rückerstattung zu verarbeiten.

• Frühe Stornierung: Plattformfunktion aktiviert (Admin-Einstellung).
• Vorzeitige Stornierung: productType ist auto oder inventory (SMM-Autodienste verwenden in der Regel productType auto).
• Frühe Stornierung: Zahlungsstatus ist abgeschlossen oder teilweise.
• Frühe Stornierung: Bestellstatus ist ausstehend, in Bearbeitung oder Fehler (Anbieterfehler werden als in Bearbeitung angezeigt).
• Vorzeitige Stornierung: keine external_id (Bestellung wurde noch nicht an einen externen Lieferanten oder Anbieter gesendet).
• Frühe Stornierung: mindestens N Minuten nach Zahlungsabschluss (auto_order_early_refund_minutes, Standard 30).
• Frühe Stornierung: Der Kunde hat bei dieser Bestellung noch keine vorzeitige Selbstrückerstattung genutzt.
• Vorzeitige Stornierung: Bestellung ist nicht vollständig geliefert (bei Teillieferung erfolgt eine anteilige Rückerstattung für den nicht gelieferten Teil).
• Vorzeitige Stornierung: Der erstattungsfähige Betrag bleibt bestehen (refundedAmount ist niedriger als der Bestellgesamtbetrag).
• Frühe Stornierung: kein aktiver Streitfall zur Bestellung.
• Frühe Stornierung: kein Lieferantenrückzug im Status "angefordert" oder "abgeschlossen".

Bei Teillieferung erfolgt eine anteilige Teilrückerstattung; gelieferte Konten bleiben erhalten.

Beispielanfrage:

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

Beispielantwort:

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

Stornierung zulassen

Prüfen, ob eine oder mehrere Bestellungen sofort storniert werden können (gleiche Berechtigungsregeln wie bei Stornierung, jedoch wird keine Rückerstattung verarbeitet). Vor dem Aufruf von "Stornierung erstellen" verwenden, um fehlgeschlagene Anfragen zu vermeiden. Unterstützt Batch-Bestell-IDs (durch Komma getrennt, bis zu 100).

Alle folgenden Punkte müssen zutreffen. Verwende allowcancel, um die Berechtigung zu prüfen, ohne eine Rückerstattung zu verarbeiten.

• Frühe Stornierung: Plattformfunktion aktiviert (Admin-Einstellung).
• Vorzeitige Stornierung: productType ist auto oder inventory (SMM-Autodienste verwenden in der Regel productType auto).
• Frühe Stornierung: Zahlungsstatus ist abgeschlossen oder teilweise.
• Frühe Stornierung: Bestellstatus ist ausstehend, in Bearbeitung oder Fehler (Anbieterfehler werden als in Bearbeitung angezeigt).
• Vorzeitige Stornierung: keine external_id (Bestellung wurde noch nicht an einen externen Lieferanten oder Anbieter gesendet).
• Frühe Stornierung: mindestens N Minuten nach Zahlungsabschluss (auto_order_early_refund_minutes, Standard 30).
• Frühe Stornierung: Der Kunde hat bei dieser Bestellung noch keine vorzeitige Selbstrückerstattung genutzt.
• Vorzeitige Stornierung: Bestellung ist nicht vollständig geliefert (bei Teillieferung erfolgt eine anteilige Rückerstattung für den nicht gelieferten Teil).
• Vorzeitige Stornierung: Der erstattungsfähige Betrag bleibt bestehen (refundedAmount ist niedriger als der Bestellgesamtbetrag).
• Frühe Stornierung: kein aktiver Streitfall zur Bestellung.
• Frühe Stornierung: kein Lieferantenrückzug im Status "angefordert" oder "abgeschlossen".

Wenn allowcancel auf 1 gesetzt ist, enthält die Antwort refundAmount (der Betrag, den die Stornierung erstatten würde).

Beispielanfrage:

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

Beispielantwort:

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

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.