Integrar el Circle REST API dentro de un proyecto Next.js es más directo de lo que parece. El flujo completo —crear un usuario, obtener un session token y generar una billetera— se resuelve con tres llamadas POST organizadas en carpetas claras dentro del directorio API del servidor.
¿Cómo se estructura el servidor Next.js para comunicarse con Circle?
El repositorio del servidor Next.js actúa como puente entre el Circle REST API y la aplicación iOS [0:10]. Dentro de la carpeta api se organizan tres categorías principales:
- Transacciones: endpoints relacionados con movimientos de fondos.
- Usuarios: creación y autenticación de cuentas.
- Billeteras: gestión de wallets en la red elegida.
Esta separación permite mantener el código modular y escalable. Cada categoría contiene su propio archivo route.js donde se definen los métodos HTTP correspondientes.
¿Cuál es el flujo para crear un usuario con el Circle REST API?
El proceso sigue exactamente los mismos pasos que se realizan en la plataforma web de Circle, pero ahora de forma programática [0:42].
¿Cómo se crea un usuario nuevo?
El primer paso es enviar una petición POST al base URL con el endpoint /users [0:50]. Lo único que se requiere en el cuerpo de la solicitud es un user ID, que es un identificador único generado previamente. Este mismo identificador se utilizó en la plataforma de Circle durante las clases anteriores.
¿Cómo se obtiene el session token?
Una vez creado el usuario, el siguiente paso es generar el session token [1:08]. Se envía otra petición POST al endpoint /users/token, pasando el mismo user ID. El servidor recibe la respuesta y la procesa para continuar con el flujo de autenticación.
¿Cómo se inicia la cuenta y se obtiene el challenge ID?
El tercer y último paso es iniciar la cuenta del usuario y obtener el challenge ID [1:22]. Esta petición POST requiere tres elementos:
- El unique ID del usuario.
- Los dos valores que se copiaron de la plataforma de Circle en pasos anteriores.
- La red blockchain en la que se desea crear la billetera.
Estos son los mismos parámetros que se configuraron manualmente en la interfaz de Circle. Después de esta llamada, el servidor escribe código para manejar la respuesta y completar la creación de la wallet.
¿Qué alternativas existen si no usas Next.js?
Si no tienes experiencia con Next.js, el Circle REST API también se puede consumir desde otros entornos [1:56]:
- Node.js.
- Ruby.
- PHP.
- Python.
La lógica es la misma: peticiones POST con los datos requeridos y manejo de respuestas. Lo que cambia es la sintaxis del lenguaje.
Descargar el repositorio del proyecto es la mejor forma de explorar cada archivo y comprobar que usar estos métodos del API resulta bastante accesible. Si te interesa profundizar en Next.js, los cursos disponibles en Platzi cubren los fundamentos necesarios para trabajar con este framework. En la siguiente sesión se abordan los distintos SDKs disponibles para crear aplicaciones en Android, iOS y web, lo que amplía las opciones de integración con Circle.
