Pimberly API

El componente Pimberly API permite a los usuarios de Nappai obtener una lista de productos desde la plataforma Pimberly. Solo necesitas indicar la fecha a partir de la cual quieres ver los productos actualizados y cuántos resultados deseas recibir. El componente se conecta automáticamente a la API de Pimberly usando la credencial que hayas configurado previamente.

¿Cómo funciona?

Cuando arrastras el componente al flujo, Nappai crea una solicitud HTTP a la API de Pimberly. Primero verifica la credencial “Pimberly API” que contiene tu clave secreta. Luego envía una petición con los parámetros que hayas configurado:

• Since Date: la fecha mínima de actualización de los productos (por ejemplo, 2023-01-01). Si lo dejas vacío, se recuperan todos los productos.
• Max Results: cuántos productos quieres que devuelva la API (el valor por defecto es 10).

La respuesta de la API se convierte en una lista de objetos Data. Cada objeto representa un producto y puede ser usado en otras partes del flujo, como en visualizaciones o en procesos de automatización.

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede ser rellenado con un valor fijo, conectado a la salida de otro componente o calculado con JavaScript.

• Max Results: El número máximo de productos que quieres recibir. Si no lo cambias, el valor por defecto es 10.
• Since Date: La fecha a partir de la cual quieres ver los productos actualizados. Debe estar en formato YYYY-MM-DD. Si lo dejas en blanco, se obtendrán todos los productos disponibles.

Nota importante: Este componente necesita una credencial de tipo Pimberly API.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Pimberly API”.
2. Ingresa tu Pimberly API Key en el campo correspondiente.
3. En el componente, selecciona la credencial que acabas de crear en el campo “Credential”.

Salidas

• Data: Una lista de objetos Data, cada uno representando un producto obtenido de Pimberly. Puedes usar esta salida para alimentar gráficos, tablas o cualquier otro proceso de automatización dentro de Nappai.

Ejemplo de Uso

1. Arrastra el componente Pimberly API al flujo.
2. Configura la credencial “Pimberly API” como se indica arriba.
3. Establece Since Date a 2023-01-01.
4. Deja Max Results en su valor por defecto (10) o cámbialo según necesites.
5. Conecta la salida Data a un componente de visualización, como un gráfico de barras, para mostrar los productos más recientes.

Consejos y Mejores Prácticas

• Limita el número de resultados: Si solo necesitas un subconjunto de productos, ajusta Max Results para reducir la carga de datos y acelerar el flujo.
• Usa fechas específicas: Al establecer una fecha concreta en Since Date, evitas procesar productos que no han cambiado, lo que ahorra tiempo y recursos.
• Revisa la credencial: Asegúrate de que la clave API esté actualizada y tenga los permisos necesarios para leer productos.
• Combina con filtros adicionales: Si la API de Pimberly ofrece más parámetros de filtrado, considera crear un componente personalizado para aprovecharlos.

Consideraciones de Seguridad

• La clave API se almacena de forma segura en la sección de credenciales de Nappai y no se expone en el flujo.
• Evita compartir la credencial con usuarios que no necesiten acceso a los datos de Pimberly.
• Si sospechas que la clave ha sido comprometida, revísala inmediatamente y genera una nueva.

---