Guía de inicio
Esta sección te ayudará a comprender cómo está organizado el espacio de trabajo para Desarrolladores y cómo empezar a usar nuestras APIs.
Catálogo de APIs
Para utilizar la API Cajeros automáticos de datos abiertos deberás solicitar tu registro.
API REST
Nuestras APIs REST (representational state transfer) permiten usar métodos HTTP estándar para interactuar y hacer operaciones CRUD (crear, leer, actualizar y eliminar) en los recursos de la API. Conoce algunas de sus características a continuación:
- La solicitud de información puede requerir el envío de diferentes parámetros en el header, query o body de la API.
- Las respuestas tienen headers, códigos de estado HTTP y JSON como payloads de respuesta.
- Todos los documentos utilizan las especificaciones Open API 2.0.
- Los documentos de referencia técnica asociados o archivos Swagger pueden consultarse desde nuestro espacio de trabajo para desarrolladores.
OAuth
Usamos el framework OAuth 2.0 para nuestras autorizaciones ya que con él evitamos que aplicaciones de terceros accedan a los datos privados de nuestros usuarios como nombre y contraseña.
Obtén una cuenta
Recomendación: instala en tu navegador la extensión ‘Disable Content Security - Policy’ para ver nuestro Portal de APIs.
Pasos de configuración en Google Chrome:
1. Para anclar la extensión a tu barra de búsqueda haz clic en extensiones del navegador y luego en la tachuela.
2. Haz clic en los tres puntos que se encuentran a lado de la extensión ‘Disable Content - Security - Policy’, después en ‘Puede leer y cambiar datos de sitios’ y luego elige alguna de las opciones disponibles. En navegadores Microsoft Edge puedes hacer un procedimiento similar.
Para probar nuestras APIs solo necesitas una cuenta con acceso a desarrolladores. Si no tienes una, llena el formulario de solicitud y espera que te notifiquemos si fue aprobada. En caso de aprobarla, te enviaremos un enlace por correo electrónico (considera que solo estará habilitado 24 horas) donde deberás ingresar el mismo correo que usaste al solicitar tu registro para crear un usuario y una contraseña. Cuando termines de configurar tu cuenta podrás iniciar sesión para comenzar.
Crea una aplicación
Para obtener tu propio Client ID y Client Secret solo sigue estos pasos:
1. Inicia sesión en nuestro Portal de APIs Banamex®.
2. Ve a la sección ‘Aplicaciones’ que se muestra en el menú superior de la página de inicio.
3. Haz clic en el botón ‘Crear aplicación’ en la pantalla de aplicaciones. Ingresa el título y la descripción de tu elección en la pantalla ‘Registrar aplicación’ y luego haz clic en el botón ‘Enviar’.
4. Al finalizar verás un mensaje de creación exitosa junto con las credenciales correspondientes. ¡Y listo! ya puedes comenzar a usar nuestra API cajeros automáticos.
