Documentación API

Integra Viewencer en tus aplicaciones con nuestra API RESTful

Comenzar

La API de Viewencer te permite integrar nuestros servicios directamente en tus aplicaciones. Nuestra API RESTful utiliza JSON para todas las respuestas.

URL Base
https://api.viewencer.com/v1/
Características
  • API RESTful con respuestas JSON
  • Autenticación mediante API Key
  • Rate limiting: 1000 requests/hora
  • Soporte HTTPS únicamente

Autenticación

Todas las requests requieren autenticación mediante API Key. Puedes obtener tu API Key desde tu panel de usuario.

Header de Autenticación
Authorization: Bearer YOUR_API_KEY
Importante: Mantén tu API Key segura y nunca la compartas públicamente.

Endpoints

GET Obtener Servicios

Obtiene la lista de todos los servicios disponibles.

GET /services
Respuesta de Ejemplo:
{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Instagram Followers",
      "category": "Instagram",
      "rate": "0.015",
      "min": 100,
      "max": 100000,
      "description": "High quality Instagram followers"
    }
  ]
}
POST Crear Orden

Crea una nueva orden para un servicio específico.

POST /orders
Parámetros:
Parámetro Tipo Requerido Descripción
service integer ID del servicio
link string URL del perfil/post
quantity integer Cantidad deseada
Ejemplo de Request:
{
  "service": 1,
  "link": "https://instagram.com/example",
  "quantity": 1000
}
GET Estado de Orden

Obtiene el estado actual de una orden específica.

GET /orders/{order_id}
Respuesta de Ejemplo:
{
  "status": "success",
  "data": {
    "id": 1234,
    "service": "Instagram Followers",
    "link": "https://instagram.com/example",
    "quantity": 1000,
    "start_count": 5000,
    "remains": 400,
    "status": "In progress",
    "created_at": "2024-01-15 10:30:00"
  }
}
GET Balance de Cuenta

Obtiene el balance actual de tu cuenta.

GET /balance
Respuesta de Ejemplo:
{
  "status": "success",
  "data": {
    "balance": "125.50",
    "currency": "USD"
  }
}

Ejemplos de Código

PHP
 1,
    'link' => 'https://instagram.com/example',
    'quantity' => 1000
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Bearer ' . $api_key,
    'Content-Type: application/json'
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>
JavaScript
const apiKey = 'YOUR_API_KEY';
const url = 'https://api.viewencer.com/v1/orders';

const data = {
    service: 1,
    link: 'https://instagram.com/example',
    quantity: 1000
};

fetch(url, {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Python
import requests
import json

api_key = 'YOUR_API_KEY'
url = 'https://api.viewencer.com/v1/orders'

data = {
    'service': 1,
    'link': 'https://instagram.com/example',
    'quantity': 1000
}

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=json.dumps(data))
result = response.json()
print(result)

Códigos de Error

Código Descripción
200 Éxito
400 Bad Request - Parámetros inválidos
401 Unauthorized - API Key inválida
403 Forbidden - Acceso denegado
404 Not Found - Recurso no encontrado
429 Too Many Requests - Rate limit excedido
500 Internal Server Error