Proveedores
GET /api/rent_email.php?method=get_providers
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_providers" | Método que se va a ejecutar. |
Cómo usar este método
Consulta los proveedores de correo habilitados y usa sus valores pcode para crear el selector. Actualiza esta lista en lugar de mantener códigos fijos. Un proveedor habilitado puede no tener buzones para un servicio concreto.
Usa el mismo pcode en servicios y precios, disponibilidad y crear un pedido.
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.
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent_email.php" \
--data-urlencode "method=get_providers"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": [
{
"id": 2,
"pcode": "gmailcom",
"name": "Gmail"
},
{
"id": 6,
"pcode": "outlookcom",
"name": "Microsoft Outlook"
}
]
}Error
{
"status": 0,
"msg": "Provider not found"
}Correcto
| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | (enum: [1]) |
data | array<object> | |
data[].id | integer | ID del proveedor. |
data[].pcode | string | Código del proveedor para filtrar y crear pedidos. |
data[].name | string | Nombre que se muestra. |
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. |