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:

Especificación OAS

¿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:

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 usuarios tienen la limitación de 100 peticiones por minuto y 1.000 peticiones al mes. Si necesitas más peticiones contacta con nosotros para solicitar un incremento de tu cuota.

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:

Especificación OAS

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.