API para desarrolladores
La API pública es un solo endpoint y solo peticiones GET: el nombre del método va en el parámetro action. El formato coincide con las plataformas populares, así que el código existente funciona con solo cambiar la URL base.
| Método | Clave | Parámetros |
|---|---|---|
| getPrices | requiere clave | action, api_key, [country], [service] |
| getCountries | requiere clave | action, api_key |
| getServicesList | requiere clave | action, api_key, [country] |
| getBalance | requiere clave | action, api_key |
| getNumber | requiere clave | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getNumberV2 | requiere clave | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getStatus | requiere clave | action, api_key, id |
| getCurrentActivationsList | requiere clave | action, api_key |
| setStatus | requiere clave | action, api_key, id, status |
getPrices
requiere clavePrecios y stock por país y servicio: cuántos números hay y a qué precio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getPrices |
| api_key | string | obligatorio | Clave de acceso del panel |
| country | string | no | Identificador del país, por ejemplo 43 |
| service | string | no | Código del servicio, por ejemplo wa |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getPrices&api_key=YOUR_API_KEY&country=43
{
"43": {
"wa": { "cost": 0.5, "count": 100 },
"tg": { "cost": 0.71, "count": 250 }
}
}getCountries
requiere claveCatálogo de países: identificador, nombres y qué modos admite el país.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getCountries |
| api_key | string | obligatorio | Clave de acceso del panel |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCountries&api_key=YOUR_API_KEY
{
"43": { "id": 43, "rus": "DE", "eng": "DE", "chn": "DE",
"visible": 1, "retry": 1, "rent": 0, "multiService": 0 }
}getServicesList
requiere claveCatálogo de servicios: código del servicio y su nombre.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getServicesList |
| api_key | string | obligatorio | Clave de acceso del panel |
| country | string | no | Identificador del país, por ejemplo 43 |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getServicesList&api_key=YOUR_API_KEY
{
"status": "success",
"services": [
{ "code": "tg", "name": "Telegram" },
{ "code": "wa", "name": "WhatsApp" }
]
}getBalance
requiere claveSaldo de la cuenta.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getBalance |
| api_key | string | obligatorio | Clave de acceso del panel |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getBalance&api_key=YOUR_API_KEY
ACCESS_BALANCE:12.50
getNumber
requiere clavePedir un número. La respuesta trae el id de activación y el número.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getNumber |
| api_key | string | obligatorio | Clave de acceso del panel |
| country | string | obligatorio | Identificador del país, por ejemplo 43 |
| service | string | obligatorio | Código del servicio, por ejemplo wa |
| duration | string | no | Duración del pedido: activation — activación única (por defecto); d1, d3, d7 — alquiler del número por 1, 3 o 7 días |
| maxPrice | string | no | Precio máximo por número. No compraremos por encima: en lugar del pedido llega WRONG_MAX_PRICE o NO_NUMBERS |
| softId | string | no | Identificador del software, hasta 255 caracteres |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumber&api_key=YOUR_API_KEY&country=43&service=wa
ACCESS_NUMBER:12345:380991234567
getNumberV2
requiere clavePedir un número: igual que getNumber, pero la respuesta correcta llega en JSON con el precio, el país y la hora de activación.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getNumberV2 |
| api_key | string | obligatorio | Clave de acceso del panel |
| country | string | obligatorio | Identificador del país, por ejemplo 43 |
| service | string | obligatorio | Código del servicio, por ejemplo wa |
| duration | string | no | Duración del pedido: activation — activación única (por defecto); d1, d3, d7 — alquiler del número por 1, 3 o 7 días |
| maxPrice | string | no | Precio máximo por número. No compraremos por encima: en lugar del pedido llega WRONG_MAX_PRICE o NO_NUMBERS |
| softId | string | no | Identificador del software, hasta 255 caracteres |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumberV2&api_key=YOUR_API_KEY&country=43&service=wa
{
"activationId": 12345,
"phoneNumber": "380991234567",
"activationCost": 0.50,
"currency": 840,
"countryCode": "43",
"canGetAnotherSms": "1",
"activationTime": "2026-07-31 12:00:00",
"activationOperator": "any"
}getStatus
requiere claveEstado de la activación: seguimos esperando el código o ya ha llegado.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getStatus |
| api_key | string | obligatorio | Clave de acceso del panel |
| id | string | obligatorio | Identificador de activación devuelto por getNumber |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getStatus&api_key=YOUR_API_KEY&id=12345
STATUS_OK:123456
getCurrentActivationsList
requiere clavePedidos activos de la clave: números que aún esperan un código o ya lo recibieron.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: getCurrentActivationsList |
| api_key | string | obligatorio | Clave de acceso del panel |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
[
{
"numberid": 12345,
"number": "380991234567",
"status": 0
}
]setStatus
requiere claveCambiar la activación: pedir otro código, finalizarla o cancelarla.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | string | obligatorio | Nombre del método: setStatus |
| api_key | string | obligatorio | Clave de acceso del panel |
| id | string | obligatorio | Identificador de activación devuelto por getNumber |
| status | string | obligatorio | Nuevo estado de la activación: 3, 6 u 8 |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=setStatus&api_key=YOUR_API_KEY&id=12345&status=6
ACCESS_ACTIVATION