Sua Chave API

Testar API

Selecione uma ação, preencha os parâmetros e envie uma solicitaçã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 requisições da 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 de categoria e subcategoria 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 Requisiçã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 Requisiçã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

Lista lojas ativas com informações básicas, contagem de produtos e avaliações. Os nomes das lojas são mascarados por privacidade.

Exemplo de Requisiçã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 esses produtos (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 por unidades de pedidos pagos em ordem decrescente (mais vendidos primeiro).

Exemplo de Requisiçã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 nessa categoria ou subcategoria (valores da API Get Categories). O parâmetro opcional shopId retorna apenas produtos e serviços para essa loja (use o shopId da Shops List). O parâmetro opcional productIds retorna apenas as linhas correspondentes (números amigáveis do serviço e/ou IDs da entidade; corresponde a linhas de product ou smm). Use action=products para filtrar apenas produtos.

Exemplo de Requisiçã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 de serviço amigável para pedidos), stock, entityType (smm ou product) e autoDelivery. 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 igualam o 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 de marketplace, o JSON inclui subproducts: uma matriz de variantes ativas, cada uma com subproductId, nome e stock (estoque exibido para essa variante).

Exemplo de Requisiçã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 rate (por unidade, mesmo formato de string da lista de serviços), entityType (smm ou product) e autoDelivery (true = entrega automática, false = fornecedor atende 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 subproducts lista todas as variantes ativas com estoque exibido; respostas de inventário SMM omitem subproducts.

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 Requisiçã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

Obtenha o status de um pedido.

Exemplo de Requisiçã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 entregas parciais, apenas as contas entregues até o momento são retornadas.

autoDelivery: true se o pedido for atendido automaticamente (ex.: SMM, produtos automáticos/de inventário); 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"
  ]
}

Status Possíveis:

Criar cancelamento

Cancelar um ou mais pedidos (formato de lote compatível com PerfectPanel). Cada pedido elegível é reembolsado no 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 automáticos geralmente usam productType auto).
• Cancelamento antecipado: status de pagamento é concluído ou parcial.
• Cancelamento antecipado: status do pedido é pendente, processando ou erro (erros do provedor aparecem como em andamento).
• 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: cliente já não usou o auto-reembolso antecipado neste pedido.
• Cancelamento antecipado: pedido não está 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 no status solicitado ou concluído.

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

Exemplo de Requisiçã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

Verifique se um ou mais pedidos podem ser cancelados agora (mesmas regras de elegibilidade do cancelamento, mas sem processar reembolso). Use antes de chamar o cancelamento para evitar requisiçõ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 automáticos geralmente usam productType auto).
• Cancelamento antecipado: status de pagamento é concluído ou parcial.
• Cancelamento antecipado: status do pedido é pendente, processando ou erro (erros do provedor aparecem como em andamento).
• 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: cliente já não usou o auto-reembolso antecipado neste pedido.
• Cancelamento antecipado: pedido não está 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 no status solicitado ou concluído.

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

Exemplo de Requisiçã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 seu saldo atual.

Exemplo de Requisiçã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.