¿Qué es una API REST?
¿Alguna vez has necesitado información específica de tu base de datos, pero encontrarla te tomaba horas? Con nuestra API REST, ese problema es cosa del pasado.
La API REST de Teamcore es un punto de acceso programático que te permite interactuar directamente con los recursos de datos almacenados en Google Cloud Platform (GCP) Big Query. Esta API es agnóstica en cuanto al lenguaje de programación y sigue los principios RESTful, lo que significa que utiliza métodos HTTP estándar como GET, POST, PUT y DELETE para operaciones CRUD (Crear, Leer, Actualizar y Eliminar).
Desarrolladores con experiencia en APIs REST
Este enfoque familiar les permitirá acceder a datos específicos a través de endpoints bien definidos, realizar consultas SQL y recibir resultados en un archivo CSV, todo ello de forma programática. Esto se realiza bajo un modelo sin estado, lo que optimiza la escalabilidad y la robustez del sistema.
Si las APIs son un concepto nuevo para ti
Piensa en esto como un "intermediario inteligente" que toma tus requisitos de información y los traduce en una solicitud de datos a nuestra base almacenada en GCP Big Query. Una vez que la solicitud es procesada, recibirás un archivo CSV con los datos solicitados, listo para ser importado en cualquier herramienta de análisis o visualización que prefieras usar.
La API también es flexible en cuanto a la personalización; puedes aplicar filtros específicos en tus consultas para obtener los datos más relevantes para tus necesidades. Esta flexibilidad hace que sea igualmente útil para desarrolladores que buscan integrar información de Teamcore en sistemas existentes, como para líderes de negocio que necesitan informes personalizados.
En resumen, la API REST de Teamcore es una herramienta potente y versátil que te da acceso directo a tu "almacén de datos", permitiendo tanto a desarrolladores como a no desarrolladores extraer información valiosa de manera eficiente y segura.
¿Qué respuesta se espera de la API?
La API REST de Teamcore tiene como objetivo ofrecer respuestas estructuradas, rápidas y precisas. Si eres un desarrollador familiarizado con APIs REST, es probable que ya sepas que la respuesta vendrá en un formato estándar, comúnmente JSON, aunque en nuestro caso específico, la información puede ser entregada como un archivo CSV para facilitar el análisis posterior.
Para aquellos que son nuevos en este concepto, imagina que has enviado una "lista de compras" de datos a través de esta API. La respuesta de la API sería como recibir tu lista de compras de vuelta, pero ahora cada artículo estará acompañado de toda la información que has solicitado. Todo estará bien organizado y fácil de entender, generalmente en un archivo CSV, que es un tipo de archivo que puedes abrir con programas como Microsoft Excel.
Ahora, hablando más técnicamente, las respuestas de la API también incluirán códigos de estado HTTP para indicar el éxito o el fracaso de la operación. Por ejemplo, un código 200 OK significa que todo ha ido bien, mientras que un 400 Bad Request indica que algo en tu solicitud no estaba claro o era incorrecto. Estos códigos son útiles tanto para el diagnóstico de problemas como para la confirmación de éxito en operaciones automatizadas.
Además, si has aplicado filtros o parámetros específicos a tu solicitud, la respuesta de la API reflejará exactamente esos criterios. Esto es especialmente útil para desarrolladores que buscan respuestas altamente personalizadas para integrar en sistemas más grandes o para análisis específicos.
En resumen, de la API REST de Teamcore puedes esperar respuestas altamente estructuradas, personalizables y acompañadas de códigos de estado claros. Todo ello diseñado para hacer tu vida más fácil, ya seas un experto en tecnología o simplemente alguien que necesita datos fiables de manera rápida y segura.
Ejemplo de una respuesta de la API REST TeamCore
{
"success": true,
"message": "Job Found",
"data": {
"id": 1234,
"username": "username",
"name": "name",
"timestamp": "2023-09-09T22:24:20.256619",
"client": "client_example",
"query_id": "6af15033-fe84-405b-8cb1-715afc94ddcd",
"query_status": "SUCCESS",
"result_url": "https://reesult_url.com"
}
}
Imagina que has enviado una petición a la API de TeamCore, algo así como mandar tu "carrito de compras inteligente" a recoger algunos datos. Lo que obtienes a cambio es una especie de "recibo digital" que te dice si tu "compra" fue exitosa y dónde puedes encontrar los "productos" que has solicitado. Veamos este recibo más de cerca:
Descomposición en dos partes
1era Parte: Estado General de la Consulta
- success: Indica si la consulta fue exitosa o no. Piensa en esto como un "Sí, tenemos tus productos" o "No, algo salió mal".
- message: Este campo te da un breve resumen de lo que ha ocurrido. En nuestro ejemplo, dice "Job Found", lo que significa que ha encontrado el trabajo de consulta que has pedido.
2da Parte: Detalles Específicos de la Consulta
- id: Este es como un número de "orden" único para tu consulta. Es útil para rastrear específicamente qué solicitaste.
- username: El nombre de usuario que realizó la consulta. Imagina que es el nombre que pusiste en la etiqueta de tu "carrito de compras inteligente".
- name: Este es el nombre humano-amigable del trabajo o consulta, algo como una "etiqueta" para saber de qué se trata.
- timestamp: La fecha y hora exactas en que se realizó la consulta. Piénsalo como el momento en que el carrito salió a recoger los productos.
- client: El nombre del cliente que realizó la consulta. Esencialmente, quién está "pagando" por estos datos o para quién son.
- query_id: Este es el identificador único de la consulta SQL en GCP Big Query. Es como un número de serie para la "receta" exacta de datos que has pedido.
- query_status: Te dice si la consulta SQL fue exitosa o no. Puedes esperar ver cosas como "SUCCESS" o "FAILURE" aquí.
- result_url: Este es el enlace donde puedes descargar el archivo CSV con los datos que has solicitado. Piénsalo como la "caja" donde han guardado todos tus productos.
En resumen, esta respuesta de la API te da una confirmación y seguimiento detallado de tu consulta, tanto para confirmar que todo salió según lo planeado como para darte las "instrucciones" sobre dónde encontrar los datos que has solicitado.
Ambientes
La infraestructura de la API REST de Teamcore ofrece diferentes "ambientes" para facilitar tanto la implementación como las pruebas. Si nunca has trabajado con distintos ambientes de desarrollo, podrías pensar en ellos como "escenarios de práctica" y "escenarios reales". Para aquellos que están familiarizados con este concepto, sabrán que un ambiente como "Sandbox" es esencial para una integración exitosa.