Sua Chave API

Testar API

Selecione uma ação, preencha os parâmetros e envie uma requisição. Quando estiver logado, sua chave de API é carregada automaticamente.

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

Endpoint da API

Todas as solicitações de API devem ser enviadas via HTTP POST para este endpoint.

Idioma opcional (lang)

Opcional. Código do idioma de destino. Use um dos códigos suportados listados abaixo. Quando definido e diferente de en, os campos traduzíveis são retornados nesse idioma. Se uma tradução ainda não estiver disponível, a API retorna em inglês.

Suportado em ações de leitura: categories, subcategory_info, services, products, inventory ((nomes de subprodutos)), sms_projects, e sms_countries. Omita lang ou use en para inglês.

Os parâmetros de filtro category e subcategory em serviços/produtos sempre usam nomes canônicos em inglês, mesmo quando lang está definido.

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

Obter Categorias

Obtenha todas as categorias e as subcategorias de cada categoria. Use esses valores para filtrar a Lista de Serviços por categoria ou subcategoria.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Informações da Subcategoria

Obter detalhes da subcategoria pelo subcategoryId, incluindo a categoria pai. Use o subcategoryId das linhas da Lista de Produtos.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Lista de Lojas

Listar lojas ativas com informações básicas, quantidade de produtos e avaliações. Os nomes das lojas estão ocultos por questões de privacidade.

Exemplo de Solicitação:

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

Com paginação:

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

Lista de Produtos

Listar apenas produtos do marketplace (sem serviços SMM). Mesmos campos das linhas de produtos na Lista de Serviços, incluindo id (id da entidade do produto), service (número amigável do serviço), description e imageUrl. O campo opcional productIds retorna apenas os produtos especificados (números amigáveis de serviço da lista e/ou ids de entidade do produto, separados por vírgula ou array JSON, máximo 100). O campo opcional sort=sold ordena os resultados pelas unidades de pedido pagas em ordem decrescente (mais vendidos primeiro).

Exemplo de Solicitação:

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

Filtrar por IDs de produto:

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

Com paginação:

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

Filtrar por categoria ou subcategoria:

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"

Mais vendidos em uma subcategoria:

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"

Apenas produtos recomendados:

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

Lista de Serviços

Obtenha todos os serviços disponíveis com paginação opcional. Cada linha inclui id (ID da entidade), service (número amigável do serviço), stock e entityType (smm ou product). O parâmetro opcional entityType retorna apenas linhas de product ou apenas de smm. Os parâmetros opcionais category e subcategory retornam apenas serviços daquela categoria ou subcategoria (valores da API Get Categories). O parâmetro opcional shopId retorna apenas produtos e serviços daquela loja (use shopId da Shops List). O parâmetro opcional productIds retorna apenas as linhas correspondentes (números amigáveis de serviço e/ou IDs de entidade; corresponde a linhas de product ou smm). Use action=products para filtrar apenas produtos.

Exemplo de Solicitação:

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

Com paginação:

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

Filtrar por categoria ou subcategoria:

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"

Filtrar por tipo de entidade:

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

Exemplo de Resposta:

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

Cada linha inclui id (id da entidade) e service (número amigável do serviço para pedidos), stock, entityType (smm ou product) e autoDelivery. As linhas de produto também incluem description, imageUrl, isRecommended e subcategoryId. Quando limit é 0 ou omitido, todos os serviços são retornados e page/limit igual ao total.

Verificar Estoque

Obtenha o estoque atual e a disponibilidade de um serviço pelo seu ID (mesmo ID da lista de serviços). Para produtos do marketplace, o JSON inclui subprodutos: uma matriz de variantes ativas, cada uma com subproductId, nome e estoque (estoque exibido para aquela variante).

Exemplo de Solicitação:

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

Exemplo de Resposta (SMM):

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

Exemplo de Resposta (produto):

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

A resposta inclui taxa (por unidade, mesmo formato de string da lista de serviços), entityType (smm ou product) e autoDelivery (true = entrega automática, false = fornecedor realiza manualmente). Para serviços de produto, min e max correspondem à linha do subproduto principal na lista de serviços; se esse subproduto não puder atender ao seu pedido de adição, a plataforma pode selecionar outro subproduto e cobrar seu preço unitário. A matriz de subprodutos lista cada variante ativa com estoque exibido; respostas de inventário SMM omitem subprodutos.

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.

Exemplo de Solicitação:

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"

Exemplo de Resposta:

{
  "order": 23501
}

Status do Pedido

Obter o status de um pedido.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Para pedidos de produtos (ex: contas), quando o pedido é entregue total ou parcialmente, a resposta inclui um array "accounts" com as credenciais das contas entregues (uma string por conta). Para entrega parcial, apenas as contas entregues até o momento são retornadas.

autoDelivery: true se o pedido for atendido automaticamente (ex.: SMM, produtos automáticos/de estoque); false se o fornecedor precisar atender manualmente (pode levar algum tempo).

Exemplo de Resposta (pedido de produto com contas entregues):

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

Possíveis Status:

Criar cancelamento

Cancelar um ou mais pedidos (formato de lote compatível com PerfectPanel). Cada pedido elegível é reembolsado em seu saldo.

Todas as condições a seguir devem ser verdadeiras. Use allowcancel para verificar a elegibilidade sem processar um reembolso.

• Cancelamento antecipado: recurso da plataforma ativado (configuração de administrador).
• Cancelamento antecipado: productType é auto ou inventory (serviços SMM auto geralmente usam productType auto).
• Cancelamento antecipado: status do pagamento é completed ou partial.
• Cancelamento antecipado: status do pedido é pending, processing ou error (erros do provedor aparecem como in progress).
• Cancelamento antecipado: sem external_id (pedido ainda não enviado a um fornecedor ou provedor externo).
• Cancelamento antecipado: pelo menos N minutos desde a conclusão do pagamento (auto_order_early_refund_minutes, padrão 30).
• Cancelamento antecipado: o cliente já não usou o auto-reembolso antecipado neste pedido.
• Cancelamento antecipado: o pedido não foi totalmente entregue (entrega parcial gera um reembolso proporcional pela parte não entregue).
• Cancelamento antecipado: valor reembolsável restante (refundedAmount é menor que o total do pedido).
• Cancelamento antecipado: sem disputa ativa no pedido.
• Cancelamento antecipado: sem retirada do fornecedor nos status requested ou completed.

Entrega parcial gera um reembolso parcial proporcional; as contas entregues são mantidas.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Permitir cancelamento

Verificar se um ou mais pedidos podem ser cancelados agora (mesmas regras de elegibilidade do cancelamento, mas nenhum reembolso é processado). Use antes de chamar o cancelamento para evitar solicitações com falha. Suporta IDs de pedidos em lote (separados por vírgula, até 100).

Todas as condições a seguir devem ser verdadeiras. Use allowcancel para verificar a elegibilidade sem processar um reembolso.

• Cancelamento antecipado: recurso da plataforma ativado (configuração de administrador).
• Cancelamento antecipado: productType é auto ou inventory (serviços SMM auto geralmente usam productType auto).
• Cancelamento antecipado: status do pagamento é completed ou partial.
• Cancelamento antecipado: status do pedido é pending, processing ou error (erros do provedor aparecem como in progress).
• Cancelamento antecipado: sem external_id (pedido ainda não enviado a um fornecedor ou provedor externo).
• Cancelamento antecipado: pelo menos N minutos desde a conclusão do pagamento (auto_order_early_refund_minutes, padrão 30).
• Cancelamento antecipado: o cliente já não usou o auto-reembolso antecipado neste pedido.
• Cancelamento antecipado: o pedido não foi totalmente entregue (entrega parcial gera um reembolso proporcional pela parte não entregue).
• Cancelamento antecipado: valor reembolsável restante (refundedAmount é menor que o total do pedido).
• Cancelamento antecipado: sem disputa ativa no pedido.
• Cancelamento antecipado: sem retirada do fornecedor nos status requested ou completed.

Quando allowcancel é 1, a resposta inclui refundAmount (o valor que o cancelamento reembolsaria).

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Saldo

Obtenha o seu saldo atual.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

SMS Verification API

Endpoints dedicados para serviços de verificação por 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"
}

Respostas de Erro

Respostas de erro comuns que você pode encontrar.