--- title: relBase API Rest - Primeros pasos description: A continuación se detallan los primeros pasos respecto a trabajar con API Rest. --- [Saltar al contenido](https://ayuda.relbase.pe/relbase-api-rest-primeros-pasos#main-content) Español - México Traducciones de Mostrar submenú para ![logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd (1).webp\]](https://ayuda.relbase.pe/hs-fs/hubfs/logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd%20(1).webp?height=31&name=logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd%20(1).webp) Abrir navegación principal Cerrar navegación principal - Español - México Traducciones de Mostrar submenú para - Ir a relbase.pe Ir a relbase.pe Hola. ¿Te ayudamos a encontrar lo que necesitas? - No hay sugerencias porque el campo de búsqueda está vacío. 1. [Centro de ayuda Perú](https://ayuda.relbase.pe/?hsLang=es-mx) 2. [Integraciones](https://ayuda.relbase.pe/integraciones?hsLang=es-mx) 3. [General](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#general) # relBase API Rest - Primeros pasos ## A continuación se detallan los primeros pasos respecto a trabajar con API Rest. #### **Versión de la API** La versión actual de la API es **v1** y permite la creación de documentos tributarios electrónicos (DTE), cotizaciones y notas de ventas. Si se cambia la versión de la API, aumentaremos el número de versión y mantendremos un soporte estable para las direcciones URL antiguas. La documentación de cada endpoint se encuentra en la siguiente URL: [https://apidocs.relbase.pe](https://apidocs.relbase.pe) **Autenticación** La API utiliza una autenticación basada en un token de empresa y usuario. El token de la empresa debe ser solicitado a [contacto@relbase.pe](mailto:contacto@relbase.pe) y el del usuario integrador debe ser creado para estos fines con los privilegios que se necesiten desde la cuenta de la empresa en relBase. El token de autenticación del usuario integrador se puede desactivar, cambiar o limitar los privilegios siempre desde relBase en la opción Configuración \>Usuarios. ![](https://ayuda.relbase.pe/hs-fs/hubfs/image-png-Jun-22-2025-08-40-32-7097-PM.png?width=563&height=239&name=image-png-Jun-22-2025-08-40-32-7097-PM.png) Es importante destacar que se recomienda crear un nuevo usuario integrador para cada aplicación que desee conectar a relBase. No es aconsejable reutilizar el token del usuario integrador. **Autenticación Básica** Supongamos que el token del usuario integrador es XXXXXX y el token de la empresa es YYYYYY. A continuación, presentamos un ejemplo para realizar una llamada al endpoint de productos utilizando estos tokens: ``` curl -H "company: YYYYYY" -H "authorization: XXXXXX" -X GET "https://api.relbase.cl/api/v1/productos" ``` **Rate Limit (Límite de Velocidad)** Puedes realizar un máximo de 7 (siete) solicitudes por segundo a la API. Si excedes este límite, recibirás una respuesta de error 403 Prohibido (Límite de velocidad excedido) para las solicitudes posteriores. Estos límites son esenciales para garantizar que los recursos se utilicen de manera eficiente y equitativa. Es fundamental que tu integración tenga en cuenta estos límites y esté preparada para manejar cualquier solicitud que falle debido a la superación del límite de velocidad. Para ayudarte a comprender cómo manejar este escenario, te proporcionamos el siguiente código de Ruby como ejemplo: ``` tries = 0; max_tries = 3;begin HTTParty.send(method, uri) # perform an API call. sleep 0.5 tries += 1rescue unless tries >= max_tries sleep 1.0 # wait the necessary time before retrying the call again. retry endend ``` **Paginación** Por defecto, la API devolverá 12 registros (productos, DTEs, etc.) por página. Si el conjunto de resultados es extenso y se requiere paginación, se proporcionará una estructura llamada "meta" que contiene información detallada acerca de la paginación. ``` "meta": { "code": 200, "message": "success", "current_page": 1, "next_page": 2, "prev_page": -1, "total_pages": 50, "total_count": 591} ``` Es tu responsabilidad verificar si hay más objetos en páginas adicionales. Esto se logra mediante el uso del parámetro "&page=2", "&page=3" y así sucesivamente para acceder a las páginas siguientes y obtener más registros. ``` curl -H "company: YYYYYY" -H "authorization: XXXXXX" -X GET "https://api.relbase.cl/api/v1/productos?page=2" ``` Si tienes más preguntas o necesitas asistencia adicional, no dudes en contactarnos a través de [contacto@relbase.pe](mailto:contacto@relbase.pe). - [Primeros Pasos](https://ayuda.relbase.pe/primeros-pasos?hsLang=es-mx#main-content) - [Paso 1: Nuevos productos](https://ayuda.relbase.pe/primeros-pasos?hsLang=es-mx#paso-1-nuevos-productos) - [Paso 2: Carga de stock](https://ayuda.relbase.pe/primeros-pasos?hsLang=es-mx#paso-2-carga-de-stock) - [Paso 4: Realizar ventas](https://ayuda.relbase.pe/primeros-pasos?hsLang=es-mx#paso-4-realizar-ventas) - [Personaliza tu cuenta](https://ayuda.relbase.pe/primeros-pasos?hsLang=es-mx#personaliza-tu-cuenta) - [SUNAT](https://ayuda.relbase.pe/primeros-pasos?hsLang=es-mx#sunat) - [Clientes](https://ayuda.relbase.pe/clientes?hsLang=es-mx#main-content) - [Creación y edición](https://ayuda.relbase.pe/clientes?hsLang=es-mx#creaci%C3%B3n-y-edici%C3%B3n) - [Acciones sobre mis clientes](https://ayuda.relbase.pe/clientes?hsLang=es-mx#acciones-sobre-mis-clientes) - [Preguntas frecuentes](https://ayuda.relbase.pe/preguntas-frecuentes?hsLang=es-mx#main-content) - [Impuesto Gratuito](https://ayuda.relbase.pe/preguntas-frecuentes?hsLang=es-mx#impuesto-gratuito) - [APP móvil](https://ayuda.relbase.pe/app-m%C3%B3vil?hsLang=es-mx) - [Ventas](https://ayuda.relbase.pe/ventas?hsLang=es-mx#main-content) - [Cotización](https://ayuda.relbase.pe/ventas?hsLang=es-mx#cotizaci%C3%B3n) - [Órdenes de trabajo](https://ayuda.relbase.pe/ventas?hsLang=es-mx#%C3%B3rdenes-de-trabajo) - [Notas de venta](https://ayuda.relbase.pe/ventas?hsLang=es-mx#notas-de-venta) - [Guías de remisión](https://ayuda.relbase.pe/ventas?hsLang=es-mx#gu%C3%ADas-de-remisi%C3%B3n) - [Facturas](https://ayuda.relbase.pe/ventas?hsLang=es-mx#facturas) - [Boletas](https://ayuda.relbase.pe/ventas?hsLang=es-mx#boletas) - [Notas de crédito](https://ayuda.relbase.pe/ventas?hsLang=es-mx#notas-de-cr%C3%A9dito) - [Notas de débito](https://ayuda.relbase.pe/ventas?hsLang=es-mx#notas-de-d%C3%A9bito) - [General](https://ayuda.relbase.pe/ventas?hsLang=es-mx#general) - [Punto de venta (POS)](https://ayuda.relbase.pe/punto-de-venta-pos?hsLang=es-mx#main-content) - [Proceso de venta](https://ayuda.relbase.pe/punto-de-venta-pos?hsLang=es-mx#proceso-de-venta) - [Cierre de caja](https://ayuda.relbase.pe/punto-de-venta-pos?hsLang=es-mx#cierre-de-caja) - [Configuración](https://ayuda.relbase.pe/punto-de-venta-pos?hsLang=es-mx#configuraci%C3%B3n) - [General](https://ayuda.relbase.pe/punto-de-venta-pos?hsLang=es-mx#general) - [Compras](https://ayuda.relbase.pe/compras?hsLang=es-mx#main-content) - [Factura Proveedores](https://ayuda.relbase.pe/compras?hsLang=es-mx#factura-proveedores) - [Gastos y Rendiciones](https://ayuda.relbase.pe/compras?hsLang=es-mx#gastos-y-rendiciones) - [Órdenes de compra](https://ayuda.relbase.pe/compras?hsLang=es-mx#%C3%B3rdenes-de-compra) - [Recaudación](https://ayuda.relbase.pe/recaudaci%C3%B3n?hsLang=es-mx#main-content) - [Funcionalidades](https://ayuda.relbase.pe/recaudaci%C3%B3n?hsLang=es-mx#funcionalidades) - [Configuración](https://ayuda.relbase.pe/recaudaci%C3%B3n?hsLang=es-mx#configuraci%C3%B3n) - [Eventos](https://ayuda.relbase.pe/eventos?hsLang=es-mx) - [Inventario](https://ayuda.relbase.pe/inventario?hsLang=es-mx#main-content) - [Movimientos de inventario](https://ayuda.relbase.pe/inventario?hsLang=es-mx#movimientos-de-inventario) - [Movimientos de almacén](https://ayuda.relbase.pe/inventario?hsLang=es-mx#movimientos-de-almac%C3%A9n) - [Configuración](https://ayuda.relbase.pe/inventario?hsLang=es-mx#configuraci%C3%B3n) - [🆕 Entregas](https://ayuda.relbase.pe/entregas?hsLang=es-mx#main-content) - [Entregas](https://ayuda.relbase.pe/entregas?hsLang=es-mx#entregas) - [Reportes](https://ayuda.relbase.pe/reportes?hsLang=es-mx#main-content) - [Reportes de venta](https://ayuda.relbase.pe/reportes?hsLang=es-mx#reportes-de-venta) - [Reportes de compra](https://ayuda.relbase.pe/reportes?hsLang=es-mx#reportes-de-compra) - [Reporte de despachos](https://ayuda.relbase.pe/reportes?hsLang=es-mx#reporte-de-despachos) - [Integraciones](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#main-content) - [Mercado libre](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#mercado-libre) - [Falabella](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#falabella) - [Ripley](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#ripley) - [Woocommerce](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#woocommerce) - [Jumpseller](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#jumpseller) - [Prestashop](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#prestashop) - [Shopify](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#shopify) - [Pedidos web](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#pedidos-web) - [General](https://ayuda.relbase.pe/integraciones?hsLang=es-mx#general) - [Configuración](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#main-content) - [Proveedores](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#proveedores) - [Categorias](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#categorias) - [Productos](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#productos) - [Packs](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#packs) - [Usuarios](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#usuarios) - [Canales de venta](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#canales-de-venta) - [Formas de pago](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#formas-de-pago) - [Descuentos y listas de precio](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#descuentos-y-listas-de-precio) - [General](https://ayuda.relbase.pe/configuraci%C3%B3n?hsLang=es-mx#general) - [Novedades](https://ayuda.relbase.pe/novedades?hsLang=es-mx#main-content) - [Actualizaciones del sistema](https://ayuda.relbase.pe/novedades?hsLang=es-mx#actualizaciones-del-sistema) [![relBase](https://ayuda.relbase.pe/hs-fs/hubfs/logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd-1.png?width=303&height=68&name=logo-relbase-normal@2x-3cb41ff14952911c096f1fce4346e95337a2289d0c98414c667897f37b9f11dd-1.png "relBase")](http://www.relbase.cl) Centro de ayuda relBase.pe Copyright © 2026, relBase