Introducción

La API de Numestri hace por HTTP todo lo que hace el panel: encontrar un número para una plataforma y un país, comprarlo, recibir el código de verificación, y alquilar números o comprar cuentas de correo al por mayor.

https://numestri.com/api/v1

Puedes explorarla ahora mismo, sin registrarte: el catálogo, las cotizaciones, los precios de alquiler y los productos de correo son públicos.

curl https://numestri.com/api/v1/catalog/platforms

Qué necesita una clave

Sin clave ves los precios de lista públicos. Con una, ves los precios de tu propia cuenta, que pueden ser distintos si tu cuenta tiene precios negociados. La tabla completa, los límites de solicitudes y cómo crear una clave están en Autenticación.

Cómo se comporta

• GET o POST, como prefieras. Todos los endpoints aceptan ambos. Los parámetros pueden ir en la query string, en un cuerpo de formulario o en un cuerpo JSON.

• Respuestas en JSON. Todas las respuestas son JSON. Los fallos llevan success: 0; consulta Errores.

• Ids exactos. Las plataformas son ids como whatsapp y los países son códigos ISO como US. Los nombres y alias se rechazan en lugar de adivinarse, así que un pedido nunca puede acabar en el servicio equivocado. Obtén los ids en el catálogo.

• Los precios los fijamos nosotros, al hacer el pedido. Nunca envías un precio. El importe que se cobra se calcula de nuestro lado cuando haces el pedido: el mismo precio que el catálogo y las cotizaciones le mostraron a tu cuenta. Envía max_price para rechazar cualquier cosa por encima de lo que esperas.

• Prepago. Los pedidos se descuentan de tu saldo en el momento de la compra. Un número que nunca recibe un código se reembolsa automáticamente.

• Formato conocido. Los endpoints de pedidos mantienen el formato de solicitud y respuesta que usan la mayoría de las API de verificación (/purchase/sms, /sms/check, order_id, type: "OUT_OF_STOCK"), así que una integración existente normalmente se migra con solo cambiar la URL base y la clave.