Servicios y precios
GET /api/rent_email.php?method=get_data
Envía una solicitud GET y comprueba status incluso con HTTP 200: 1 indica éxito, 0 fallo y 2 que no había buzones al crear el alquiler. Consulta los detalles en msg, errormsg y errorid.
Autenticación
Puedes llamar a este método sin clave API.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|---|
method | query | string | Sí | "get_data" | Método que se va a ejecutar. |
pcode | query | string | No | "outlookcom" | Código de Get Providers. Para aceptar cualquier proveedor, omite este parámetro por completo; no envíes un valor vacío ni null. |
Cómo usar este método
Consulta servicios, precios diarios y cantidades de buzones. Envía un pcode de Proveedores para filtrar o no lo incluyas para sumar los proveedores habilitados. Usa scode al crear el alquiler.
Los precios están en USD. months_discount se aplica a períodos de al menos 30 días. Solo Gmail permite alias. Actualiza la disponibilidad al cambiar de proveedor.
Ejemplos de solicitud
Entorno y dependencias. Los ejemplos codifican los parámetros y esperan hasta 30 segundos. Comprueba HTTP y status antes de usar data. cURL muestra el JSON para que lo revises; Java usa Jackson para leerlo.
Define SMSPVA_EMAIL_PCODE con un proveedor actual; sin valor se omite pcode por completo. Usa los códigos de las listas dinámicas.
provider_args=()
if [ -n "${SMSPVA_EMAIL_PCODE:-}" ]; then provider_args=(--data-urlencode "pcode=$SMSPVA_EMAIL_PCODE"); fi
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
--data-urlencode "method=get_data" \
"${provider_args[@]}"Respuestas
Consulta la respuesta correspondiente a tu solicitud. Los valores y las fechas son orientativos. Los campos opcionales pueden variar según el resultado o el formato elegido.
HTTP 200
Comprueba status aunque HTTP sea 200. Los valores de los ejemplos son orientativos.
application/json
Ejemplo de respuesta correcta
{
"status": 1,
"data": [
{
"count": 40,
"scode": "twitter",
"sname": "Twitter",
"price": 0.1,
"alias_price": 0.25,
"icon": "/templates/SMSv1EN/images/ico/twitter.png",
"months_discount": 20
}
]
}Error
{
"status": 0,
"msg": "Provider not found"
}Correcto
| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | (enum: [1]) |
data | array<object> | |
data[].count | integer | Cantidad de buzones disponibles. |
data[].scode | string | Código del servicio para crear el pedido. |
data[].sname | string | Nombre visible del servicio. |
data[].price | number | Precio diario del alquiler en USD. |
data[].alias_price | number | Precio del acceso al alias. Solo Gmail admite alias. |
data[].icon | string | Ruta del icono del servicio. |
data[].months_discount | integer | Porcentaje de descuento para alquileres de al menos 30 días. |
Obligatorios: status, data
Error
Algunos errores incluyen errorid y errormsg; otros solo msg. Comprueba todos los campos presentes.
| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | (enum: [0]) |
errorid | integer | Código numérico de error, si se incluye. |
errormsg | string | Descripción del error, si se incluye. |
msg | string | Mensaje de error. |