Documentación API

Envía key/action en cuerpo application/x-www-form-urlencoded o JSON. Se rechazan parámetros URL. Producción requiere HTTPS. GET no admitido. Ejemplos ficticios.

curl -X POST 'https://smmvelox.com/api/v2' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=123' \
  --data-urlencode 'link=https://example.com/post' \
  --data-urlencode 'quantity=1000' \
  --data-urlencode 'client_order_id=YOUR_UNIQUE_ORDER_ID' \
  --data-urlencode 'max_charge=11550'

Autenticación con clave API

Guarda la key en secreto y envíala solo en el cuerpo. Nunca en URL, código frontend ni compartida. Rotar/revocar tiene efecto inmediato. Cuenta activa y email verificado obligatorios.

Envía la clave solo en el cuerpo POST mediante HTTPS; nunca en la URL ni en código del navegador.

La API cotiza y cobra siempre en VND. El USD de la interfaz es solo informativo.

V1 solo Default con mapping/unidad verificados: rate es VND por 1.000 unidades; charge = rate × quantity / 1.000. service es DV-ID interno; order ID local estable en cadena. Sin ID del proveedor. Dinero decimal exacto hasta 12 posiciones.

key=YOUR_API_KEY&action=services

[
  {
    "service": 123,
    "name": "Example",
    "desc": "",
    "type": "Default",
    "category": "Facebook",
    "platform": "facebook",
    "rate": "11550.000000000000",
    "rate_unit": "per_1000",
    "min": "100",
    "max": "100000",
    "refill": false,
    "cancel": false,
    "dripfeed": false,
    "currency": "VND"
  }
]

La API cotiza y cobra siempre en VND. El USD de la interfaz es solo informativo.

key=YOUR_API_KEY&action=balance

{
  "balance": "100000.000000000001",
  "currency": "VND"
}

add requiere service entero positivo, link http/https hasta 2.000 caracteres y quantity entero entre min/max. Rechaza price/rate/discount/currency/user_id/status/provider y campos desconocidos. status por lotes hasta 100 ID.

key=YOUR_API_KEY&action=add&service=123&link=https://example.com/post&quantity=1000&client_order_id=YOUR_UNIQUE_ORDER_ID

{
  "order": "456"
}

Estados Pending/Processing/In progress/Completed/Partial/Canceled según evidencia. En revisión/desconocido devuelve Pending con review_required=true. start_count/remains null sin evidencia, nunca ceros inventados. charge usa instantánea pagada.

key=YOUR_API_KEY&action=status&order=456

{
  "charge": "11550",
  "status": "Pending",
  "start_count": null,
  "remains": null,
  "currency": "VND",
  "review_required": false
}

La respuesta es un objeto indexado por ID; los ID desconocidos tienen errores individuales. Máximo 100 ID.

key=YOUR_API_KEY&action=status&orders=456,999

{
  "456": {
    "charge": "11550",
    "status": "Pending",
    "start_count": null,
    "remains": null,
    "currency": "VND",
    "review_required": false
  },
  "999": {
    "error": "Incorrect order ID"
  }
}

Package/per_unit, custom comments, subscriptions, dripfeed no admitidos y ocultos. cancel/refill/refill_status devuelven HTTP 400 Action is not supported sin cambios ni reembolso automático. Los tres indicadores false en V1.

key=YOUR_API_KEY&action=cancel

{
  "error": "Action is not supported"
}

Reglas de pedidos y estados

La conexión puede fallar después de que se acepte el pedido y se cobre el saldo. Un timeout o HTTP 503 no demuestra que la solicitud no se procesó. Usa una referencia única por cada pedido previsto.

1. Antes del primer add, genera un client_order_id único (o idempotency_key) y guárdalo junto con service, link, quantity y max_charge enviados.
2. Si recibes un order ID, guárdalo y consulta action=status con order. No envíes otro add solo para consultar el estado.
3. Si hay timeout o se pierde la respuesta y no tienes order ID, reintenta solo cuando la conexión y la API estén disponibles. Reenvía exactamente el mismo action=add, referencia y parámetros originales. No generes una referencia nueva.
4. Si el reintento devuelve un order ID, sigue ese ID. Si sigue la incertidumbre, detén los reintentos automáticos repetidos y contacta con soporte indicando la referencia (nunca tu API Key).

curl -X POST 'https://smmvelox.com/api/v2' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=123' \
  --data-urlencode 'link=https://example.com/post' \
  --data-urlencode 'quantity=1000' \
  --data-urlencode 'client_order_id=YOUR_UNIQUE_ORDER_ID' \
  --data-urlencode 'max_charge=11550'

action=status requiere el order ID; no permite buscar por client_order_id. Sin ID, repite el add idéntico cuando la API esté disponible o contacta con soporte.

Ejemplos de errores JSON y cómo actuar

{
  "error": "Client order ID conflicts with an existing request"
}

{
  "error": "Invalid request parameters",
  "fields": [
    "quantity"
  ]
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "API order creation is disabled"
}

Los JSON son ejemplos de errores reales; el mensaje error puede variar según la causa. Maneja el estado HTTP y la condición correspondiente.

Códigos de estado HTTP

Los errores son objetos JSON con el campo error y no exponen datos internos.

Seguridad, límites y errores

Opcional: hasta 20 IPv4/IPv6 exactas, una por línea. Vacío permite cualquier IP. Sin CIDR. Lista inválida se rechaza y conserva la anterior.

Por minuto: 60 peticiones/IP antes de autenticar; además 120 lecturas o 15 add por usuario/key. Cuerpo máximo 64 KiB. 429 incluye Retry-After. No se confía en Forwarded/X-Forwarded-For del cliente.

FAQ: Obtén la key al entrar. Si la pierdes debes rotarla; no puede volver a mostrarse. Keys de proveedor no funcionan aquí. V1 (2026-10-30): services, balance, add Default y status individual/lotes. Posventa queda para V2 con flujos seguros.