Pedidos actuales
Lista los pedidos actuales y sus identificadores.
Autenticación
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
apikey | header | string | Sí | Tu clave API |
Parámetros
Sin parámetros de ruta o consulta. No requiere cuerpo.
Cómo usar este método
Consulta tus pedidos de activación actuales. Usa el orderId devuelto para Recibir SMS y gestionar cada pedido.
Ejemplos de solicitud
Requisitos y configuración del entorno. cURL usa un shell POSIX. El ejemplo JavaScript también es válido en TypeScript sobre Node.js. Java utiliza el cliente estándar y muestra JSON sin analizar; usa la biblioteca JSON de tu aplicación.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --fail-with-body --max-time 30 --request GET \
--url "https://api.smspva.com/activation/orders" \
--header "apikey: $SMSPVA_API_KEY"Respuestas
Los ejemplos muestran el formato de respuesta. Los precios, las cantidades y los datos de cuenta son orientativos; consulta la API para obtener valores actuales.
| HTTP | Descripción |
|---|---|
| 200 | Operación completada |
| 501 | El servidor no pudo procesar la solicitud. |
| 503 | El servidor está sobrecargado. Inténtalo más tarde. |
HTTP 200
Operación completada
Respuesta ilustrativa
{
"statusCode": 200,
"data": {
"orders": [
{
"orderId": 123456,
"phoneNumber": 987654321,
"countryCode": "+7",
"orderExpireIn": 599,
"service": "opt0",
"country": "UK",
"status": "PENDING_SMS|SMS_READY|PENDING_PAYMENT",
"sms": {
"code": "1234",
"fullText": "Your service Activation code is 1234. Don't tell it anybody"
}
}
]
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
data | object | Datos de respuesta |
data.orders | array<object> | Datos de respuesta |
data.orders[].orderId | integer | ID del pedido |
data.orders[].phoneNumber | integer | Número sin prefijo de país |
data.orders[].countryCode | string | Prefijo telefónico del país. |
data.orders[].orderExpireIn | integer | Tiempo hasta el vencimiento, en segundos |
data.orders[].service | string | Código de servicio Lista de servicios |
data.orders[].country | string | Código de país según ITU-T E.123 y E.164. Lista de países |
data.orders[].status | string | Estado del SMS. |
data.orders[].sms | object | Estado del SMS. |
data.orders[].sms.code | string | Código de activación recibido por SMS. |
data.orders[].sms.fullText | string | Texto completo del SMS. |
HTTP 501
El servidor no pudo procesar la solicitud.
Respuesta ilustrativa
{
"statusCode": 501,
"error": {
"type": "SERVER_FAIL",
"description": "Server failed to process request"
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
error | object | Datos de respuesta |
error.type | string | Tipo de error |
error.description | string | Descripción del error |
HTTP 503
El servidor está sobrecargado. Inténtalo más tarde.
Respuesta ilustrativa
{
"statusCode": 503,
"error": {
"type": "SERVER_BUSY",
"description": "Server overload, try later."
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
error | object | Datos de respuesta |
error.type | string | Tipo de error |
error.description | string | Descripción del error |
Guías relacionadas
Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.