Estado del número
Comprueba un número utilizado anteriormente para el mismo servicio.
Autenticación
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
apikey | header | string | Sí | Tu clave API |
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
number | path | string | Sí | Número sin prefijo telefónico del país. (pattern: "^[0-9]{5,}$") |
service | path | string | Sí | Código de servicio. Consulta los códigos en servicesprices. |
No requiere cuerpo de solicitud.
Cómo usar este método
Comprueba si un número que ya has usado puede seguir recibiendo SMS del mismo service. La consulta solo sirve si antes recibiste SMS de ese servicio en ese número. Envía number sin el prefijo telefónico del país.
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_NUMBER: number (obligatorio).
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_NUMBER:?Set SMSPVA_NUMBER to your number}"
curl --fail-with-body --max-time 30 --request GET \
--url "https://api.smspva.com/activation/numberstatus/${SMSPVA_NUMBER}/opt0" \
--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 |
| 405 | Formato de número no válido |
| 406 | El ID del pedido no es válido o no se encontró. |
| 500 | Error interno. La descripción puede incluir información de diagnóstico. |
| 501 | El servidor no pudo procesar la solicitud. |
| 502 | No se encontró el número. |
| 503 | El servidor está sobrecargado. Inténtalo más tarde. |
| 504 | av2.resp.504.desc: la fuente no incluye una descripción desarrollada para esta respuesta. |
HTTP 200
Operación completada
Respuesta ilustrativa
{
"statusCode": 200,
"data": {
"number": "98765432",
"orderId": 123456,
"countryCode": "+7"
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
data | object | Datos de respuesta |
data.number | string | Número sin prefijo telefónico del país. |
data.orderId | integer | ID de tu pedido anterior para ese número y servicio. |
data.countryCode | string | Prefijo telefónico del país. |
HTTP 405
Formato de número no válido
Respuesta ilustrativa
{
"statusCode": 405,
"error": {
"type": "INVALID_NUMBER_FORMAT",
"description": "Number should be integer with more than 5 digits"
}
}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 406
El ID del pedido no es válido o no se encontró.
Respuesta ilustrativa
{
"statusCode": 406,
"error": {
"type": "ORDER_NOT_FOUND",
"description": "Order not found."
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
error | object | Detalles del error |
error.type | string | Tipo de error |
error.description | string | Descripción del error |
HTTP 500
Error interno. La descripción puede incluir información de diagnóstico.
Respuesta ilustrativa
{
"statusCode": 500,
"error": {
"type": "SERVER_ERROR",
"description": "An internal error has occurred while processing your request."
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | |
error | object | |
error.type | string | |
error.description | string |
HTTP 501
El servidor no pudo procesar la solicitud.
HTTP 502
No se encontró el número.
HTTP 503
El servidor está sobrecargado. Inténtalo más tarde.
HTTP 504
av2.resp.504.desc: la fuente no incluye una descripción desarrollada para esta respuesta.
Guías relacionadas
Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.