Bienvenido al Portal para Desarrolladores del ITACyL

Estás a solo unos pasos de poder usar nuestras APIs.

¿Cómo puedo obtener una cuenta de usuario para el Portal para Desarrolladores?

Si estás interesado en probar nuestras APIs puedes crear una cuenta directamente pulsando en el icono superior de esta web. Pasarás al sistema de autenticación del ITACyL y podrás utilizar varios mecanismos de autenticación para registrarte:

• Utilizar cuentas externas: Google o Facebook.
• Utilizar certificado digital.
• Crear una cuenta utilizando un correo electrónico. En este caso, llegarás a un formulario para rellenar los datos y posteriormente te llegará un email para activar tu cuenta.

¿Cómo puedo acceder a las APIs?: Creación de un apikey

Una vez tengas creada una cuenta personal, puedes utilizar nuestras APIs solicitando una clave de acceso (apikey). Ve a la sección del catálogo y pulsa sobre el botón “solicitar clave”. El sistema iniciará un proceso de registro que al finalizar te enviará su clave por correo electrónico.

Muy importante, esta clave está asociada a tu cuenta, mantenla EN SECRETO.

Una vez tengas tu clave, deberás enviarla en todas las peticiones que hagas a los servicios como cabecera HTTP con el nombre APIKEY. En la especificación OAS de los APIS tendrás más detalles sobre los mecanismos de autenticación que cada API permite.

En la sección de documentación del correspondiente API puedes probar el acceso a las operaciones, si el API está securizado tendrás que introducir tu apikey en la sección AUTHENTICATION como se muestra en esta imagen:

¿Qué uso puedo dar a los datos de los APIs?: Licencias de uso

Por defecto, los datos publicados en este portal se publican en base a estas dos licencias:

• Para datos no cartográficos: Creative Commons Reconocimiento 4.0.
• Para datos cartográficos: Licencia LICENCIA-IGCYL-NC.

A parte, cada API puede tener su propia licencia, así que revisa la documentación del API para ver si tiene restricciones de uso adicionales.

¿Cuántas peticiones puedo hacer?: Cuota de uso

Por defecto, las cuentas de usuario tienen la limitación de 100 peticiones por minuto y 1.000 peticiones al mes. Si necesitas ampliar esta cuota, debes contactar con nosotros a través de la sección de contacto del ITACyL, adjuntando un documento que justifique la necesidad de ampliación del uso. Este documento debe incluir la siguiente información:

• Descripción del caso, indicando el uso que se hace de los datos y la justificación de la frecuencia de acceso.
• Estimación del número de peticiones mensuales y por minuto.
• Aplicación desde la que se utiliza el API (web, móvil o ambas).
• Indicar si la aplicación es gratuita o de pago.
• Número estimado de usuarios finales de tu servicio/aplicación y su perfil.
• Cómo se informará en la aplicación que los datos provienen de los servicios del ITACyL.

He perdido mi apikey, ¿cómo puedo obtener una nueva?

Esto nos pasa a todos… El portal del desarrollador solo permite tener una clave por servicio y usuario, así que si has perdido tu clave, o ha sido comprometida, primero tendrás que eliminar la existente. Para esto, ve a tu panel del desarrollador y pulsa sobre el botón "Borrar clave”. Una vez eliminada podrás crear una nueva clave.

¿Cómo puedo probar el API?: Herramientas de testeo

Desde el catálogo de APIs tienes acceso a una herramienta web de testeo del API. Otra herramienta ampliamente conocida para la pruebas con APIs es Postman, en esta herramienta puedes importar la especificación OAS del servicio, el json que aparece en la página de documentación del API:

Guarda ese fichero con extensión .json e impórtalo como una colección postman.

¿Cómo puedo informar de un problema?

Lamentamos si has tenido dificultades al utilizar nuestro servicio. Puedes contactar con nosotros a través de la sección de contacto del ITACyL y danos toda la información posible sobre el problema:

• Qué servicio estás utilizando.
• Tu dirección de correo electrónico para identificar tu cuenta.
• Qué datos estás enviando y qué error estás detectando.