Volver al inicio

Documentación API

Versión API: v2

FoxiGrow proporciona una API estándar de SMM Panel que te permite integrar nuestros servicios en tus propias aplicaciones. Esta documentación cubre todos los endpoints disponibles y su uso.

Endpoint API

https://foxigrow.com/api/v2

Todas las solicitudes deben enviarse a este endpoint mediante el método POST o GET.

Autenticación

Todas las solicitudes API requieren autenticación usando tu clave API. Puedes encontrar tu clave API en la configuración de tu cuenta. Incluye el parámetro key en cada solicitud.

POST https://foxigrow.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Formato de respuesta

Todas las respuestas se devuelven en formato JSON. Las solicitudes exitosas devuelven los datos solicitados, mientras que los errores devuelven un objeto con una descripción.

Endpoints API

Obtener servicios

Devuelve una lista de todos los servicios disponibles con sus detalles incluyendo precios, cantidades mínimas y máximas.

Parámetros

  • key - Tu clave API (requerido)
  • action - "services"
// Ejemplo de respuesta
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Obtener saldo

Devuelve el saldo actual de tu cuenta y la moneda.

Parámetros

  • key - Tu clave API (requerido)
  • action - "balance"
// Ejemplo de respuesta
{
  "balance": "100.84292",
  "currency": "USD"
}

Agregar pedido

Crear un nuevo pedido para un servicio. Los parámetros requeridos dependen del tipo de servicio.

Tipo predeterminado

  • key - Tu clave API (requerido)
  • action - "add"
  • service - ID del servicio (requerido)
  • link - URL de destino (requerido)
  • quantity - Cantidad del pedido (requerido)

Tipo paquete

  • key - Tu clave API (requerido)
  • action - "add"
  • service - ID del servicio (requerido)
  • link - URL de destino (requerido)

Tipo comentarios personalizados

  • key - Tu clave API (requerido)
  • action - "add"
  • service - ID del servicio (requerido)
  • link - URL de destino (requerido)
  • comments - Comentarios separados por salto de línea (requerido)
// Ejemplo de respuesta
{
  "order": 23501
}

Estado del pedido

Obtener el estado de uno o más pedidos. Puedes consultar un solo pedido o varios a la vez.

Pedido único

  • key - Tu clave API (requerido)
  • action - "status"
  • order - ID del pedido (requerido)

Múltiples pedidos (hasta 100)

  • key - Tu clave API (requerido)
  • action - "status"
  • orders - IDs de pedidos separados por coma (requerido)
// Ejemplo de respuesta
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Crear reposición

Solicitar una reposición para un pedido. Solo disponible para servicios que admiten reposiciones.

Parámetros

  • key - Tu clave API (requerido)
  • action - "refill"
  • order - ID del pedido (requerido)
// Ejemplo de respuesta
{
  "refill": "1"
}

Estado de reposición

Verificar el estado de una solicitud de reposición.

Parámetros

  • key - Tu clave API (requerido)
  • action - "refill_status"
  • refill - ID de reposición (requerido)
// Ejemplo de respuesta
{
  "status": "Completed"
}

Estados de pedido

  • Pending - El pedido está esperando ser procesado
  • Processing - El pedido se está preparando
  • In progress - El pedido se está ejecutando actualmente
  • Completed - El pedido se ha completado exitosamente
  • Partial - El pedido se completó parcialmente (reembolso por el resto)
  • Canceled - El pedido fue cancelado

Manejo de errores

Cuando ocurre un error, la API devuelve un objeto JSON con un campo error describiendo el problema.

// Ejemplo de respuesta de error
{
  "error": "Invalid API key"
}

Límites de tasa

Para asegurar la calidad del servicio, se aplican los siguientes límites de tasa:

  • 5 solicitudes por segundo
  • 100 solicitudes por minuto
  • 1000 solicitudes por hora

Soporte

Si tienes alguna pregunta sobre la API, contacta a nuestro equipo de soporte:

Telegram: @FoxigrowBD