{"id":19888062,"url":"https://github.com/code3743/opac-univalle-api","last_synced_at":"2025-09-02T03:40:28.438Z","repository":{"id":164069322,"uuid":"638608973","full_name":"code3743/OPAC-Univalle-API","owner":"code3743","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-04T16:58:31.000Z","size":177,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-11T19:15:05.390Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/code3743.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-05-09T18:02:21.000Z","updated_at":"2023-06-16T21:54:17.000Z","dependencies_parsed_at":"2023-07-13T07:01:09.767Z","dependency_job_id":null,"html_url":"https://github.com/code3743/OPAC-Univalle-API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code3743%2FOPAC-Univalle-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code3743%2FOPAC-Univalle-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code3743%2FOPAC-Univalle-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code3743%2FOPAC-Univalle-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code3743","download_url":"https://codeload.github.com/code3743/OPAC-Univalle-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241317596,"owners_count":19943201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T18:06:12.368Z","updated_at":"2025-03-01T04:41:21.676Z","avatar_url":"https://github.com/code3743.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OPAC  Univalle API\n\n### API no oficial del sistema OPAC de la Universidad del Valle\n\n¡Bienvenido al proyecto educativo \"API OPAC Univalle\"!\n\n\nAquí podrás encontrar una increíble API que te permite realizar consultas al sistema desde tu dispositivo móvil. ¿Por qué? Porque sabemos que no siempre es fácil acceder al catálogo desde tu teléfono. ¡Pero no te preocupes, estamos aquí para ayudarte!\n\n\nQueremos destacar que la velocidad de respuesta puede depender de la velocidad del sistema web OPAC. Utilizamos métodos de Web Scraping para obtener la información necesaria y brindarte una experiencia única.\n\n\nRecuerda que este proyecto tiene fines educativos, ¡así que diviértete explorando y aprendiendo! Si tienes alguna pregunta, no dudes en contactarnos.\n\n\n¡Disfruta del viaje!\n\n#### Funciones\n\n- obtener informacion del usuario (Historial de prestamos, Prestamos activos, Multa e informacion personal)\n- renovar libros, se puede renovar un libro o todos.\n- buscar libros, permite obtener los 10 primeros resultados de coincidencia\n- ver detalles del ejemplar (Ubicación, disponibilidad, numero de ejemplares)\n- generar citas en formato APA 7\n- buscar en las bases de datos de la Universidad deL Valle\n- listar todas las bases de datos de la Universidad\n \n\n### endpoints principales\n\n1. ` {dominio}/api/login?codigo=CODIGO_ESTUDIANTE`\nobtener la informacion principal del OPAC\n\n**parametros:**\n- codigo: Codigo del estudiante tal cual como inicia sesión en el OPAC Web\n\n**Respuesta:**\n\n```sh\n{\n    nombre: string,\n    apellido: string,\n    fechaExpiracion :string,\n    multa: string,\n    librosPrestados: [\n        {\n        index: number,\n        codigo: string,\n        titulo: string,\n        fecha: string,\n        multa: string\n        }\n        ...\n    ],\n    historialPrestamos: [\n        {\n        codigo: string,\n        titulo: string,\n        fecha: string\n        }\n        ...\n    ]\n}\n```\n\n2. ` {dominio}/api/renovar/INDEX_LIBRO/?codigo=CODIGO_ESTUDIANTE`\nRenovar libro por index, el index debe ser el mismo que retonar cada uno de los libros en prestamos\n\n**parametros:**\n- codigo: Codigo del estudiante tal cual como inicia sesión en el OPAC Web\n- INDEX_LIBRO: nuemro del libro que se desea renovar\n\n**Respuesta:**    \n```sh\n{\n    total: number,\n    estado:  [\n        {\n        titulo: string,\n        fecha: string\n        }\n    ],\n}\n```\n\n\n3. ` {dominio}/api/renovar/?codigo=CODIGO_ESTUDIANTE`\nRenovar todo los libros en prestamo\n**parametros:**\n- codigo: Codigo del estudiante tal cual como inicia sesión en el OPAC Web\n\n**Respuesta:**    \n```sh\n{\n    total: number,\n    estado:  [\n        {\n        titulo: string,\n        fecha: string\n        }\n        ...\n    ],\n}\n```\n\n4. ` {dominio}/api/buscar?q=NOMBRE_EJEMPLAR`\nRetorna un listado de maximo 10 resultados\n\n**parametros:**\n- q: El nombre del libro que se desee buscar\n\n**Respuesta:**    \n```sh\n{\n    tituloBuscado: string,\n    totalResultados : number,\n    resultadosBusqueda : [\n        {\n            id: string,\n            nombre: string,\n            autor: string,\n            ISBN: string | null,\n            detalle: string,\n            ejemplares: string,\n            imagenUrl: string | null\n        }\n        ...\n    ]\n}\n```\n\n5. ` {dominio}/api/detalle/isbn/ISBN_LIBRO`\nRetorna informacion detallada de un ejemplar por medio del ID obtenido en resultadosBusqueda\n\n**parametros:**\n- ISBN_LIBRO: isbn retornado en la busqueda\n\n**Respuesta:**    \n```sh\n{\n    imagen: string | null,\n    resumen: string,\n    disponibilidad: [{\n        codigo: string\n        localizacion: string\n        estante: string\n        signatura: string\n        coleccion: string\n        estado: string\n        categoria: string\n    }\n    ...\n    ]\n}\n```\n\n6. ` {dominio}/api/detalle/oid/OID`\nRetorna informacion detallada de un ejemplar por medio del ID obtenido en resultadosBusqueda\n\n**parametros:**\n- OID: isbn retornado en la busqueda\n\n**Respuesta:**    \n```sh\n{\n    imagen: string | null,\n    resumen: string,\n    disponibilidad: [{\n        codigo: string\n        localizacion: string\n        estante: string\n        signatura: string\n        coleccion: string\n        estado: string\n        categoria: string\n    }\n    ...\n    ]\n}\n```\n\n7. ` {dominio}/api/cita?isbn=ISBN`\nRetorna la cita del ejemplar en formato APA 7 Ed.\n\n**parametros:**\n- ISBN: identificador unico del ejemplar (10 o 13)\n\n**Respuesta:**    \n```sh\n{\n  autores: string,\n  anioPublicacion: string,\n  tituloLibro: string,\n  subtitulo: string,\n  numeroEdicion: string,\n  editorial: string,\n  citaAPA: string\n}\n```\n\n¡A explorar y disfrutar de nuestra API OPAC Univalle! Si tienes alguna pregunta, no dudes en contactarnos. Estamos aquí para hacer de tu experiencia bibliotecaria algo grandioso. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode3743%2Fopac-univalle-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode3743%2Fopac-univalle-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode3743%2Fopac-univalle-api/lists"}