Entregar la llave y la URL a quien te integra

Le das a quien te integra lo que necesita para conectarse —la dirección, la forma de presentar la llave y la documentación— sin darle entrada a tu cuenta de Pitflo.

Antes de empezar#

• Necesitas el permiso de «Integraciones» con alcance de «Toda la empresa» (de fábrica, el Superadministrador y el Administrador) y el plan Empresarial.
• Necesitas una API ya creada y la llave que guardaste al crearla. La ficha no la vuelve a mostrar: si la perdiste, rota el token y entrega la nueva.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones» y abre tu API. Si tienes varias sucursales, elige primero la fila «Todas las sucursales» en el selector de arriba del menú.
2. En el panel «Cómo consultar», pulsa «Copiar URL» junto a «URL del recurso». Es la dirección de uno de tus recursos; para consultar otro, se cambia la última palabra por cualquiera de los que tu API expone.
3. Pulsa «Copiar» junto a «Cabecera de autenticación». Es la forma en que tu proveedor presenta la llave: donde dice TU_LLAVE va el token.
4. Pulsa «Documentación». Se abre en otra pestaña la documentación pública de Pitflo; copia su dirección. No pide sesión: tu proveedor la abre sin tener cuenta.
5. Manda a tu proveedor la URL, la cabecera y la liga de la documentación. La llave entrégala aparte, por un medio seguro: quien la tenga puede leer todo lo que tu API expone.

Resultado#

Tu proveedor ya puede consultar. En cuanto lo haga, la lista de «Integraciones» lo dice en su columna «Última llamada», y la ficha debajo del nombre de la API: cuándo se usó la llave y desde qué dirección de internet. Mientras nadie consulte, ahí se lee «sin uso todavía».

Preguntas frecuentes#

¿Mi proveedor puede modificar algo en Pitflo? No. Por esta vía solo se consulta: nadie crea, cambia ni borra nada. El panel lo resume así: «Solo GET. Paginado con cursor; máximo 100 por página.»

¿Tiene que bajar todo cada vez? No. Puede pedir solo lo que cambió desde una fecha, acotar a una sucursal y leer por bloques de hasta 100 registros, siguiendo donde se quedó sin repetir ni saltarse renglones. Los importes viajan en centavos; su sistema les da formato.

¿Qué encuentra en la documentación? Los recursos con sus campos, los «Eventos disponibles» y cómo comprobar que un aviso viene de Pitflo, los límites, el «Anexo de niveles de servicio (SLA)», el «Estado de la plataforma» y la «Respuesta para RFPs». Como es pública, también la puedes enseñar en una licitación.

¿Quién cuida los datos que se copian? Tú. La pantalla lo advierte: «Lo que copies a tu sistema queda bajo tu resguardo — incluidas las bajas de datos de tus clientes». Y la llave es de servidor: nunca va en una página web ni en una app del teléfono.