Conector API manual
Para APIs que no están en el catálogo de integraciones o cuando quieres controlar cada detalle. Ve a Importar e integrar → Conectores API.
1. Crear el conector
- Nombre y URL base (
https://api.ejemplo.com/v1). - Autenticación: ninguna, Bearer token, API key en cabecera o en la URL, usuario y contraseña (Basic) u OAuth2 client credentials (Client ID + Secret: Tablifyx pide y renueva el token solo). Las credenciales se guardan cifradas.
- Cabeceras adicionales si la API las necesita.
2. Endpoints: la forma rápida
- Pulsa Nuevo endpoint y escribe la ruta (
/orders), la paginación y, si hace falta, la ruta de los registros. - Junto al campo Modelo, pulsa Crear con datos reales: Tablifyx llama a la API con lo que hay en el formulario (aunque aún no lo hayas guardado), analiza los registros que devuelve (con IA si está disponible) y crea el modelo, sus campos, las sublistas como modelos hijos y el mapeo, que quedan rellenados en el formulario.
- Guarda el endpoint y pulsa Sincronizar.
2 bis. Con la documentación y la IA
En la pestaña Documentación para la IA indica la URL de la documentación u OpenAPI, pégala, o pega una respuesta JSON de ejemplo, y pulsa Analizar con IA.
La pestaña Propuesta de la IA muestra, antes de crear nada, cada endpoint propuesto: ruta, si es de lectura o envío, el modelo de destino, dónde están los registros, la paginación, la frecuencia y los campos. Con Probar ves lo que devuelve tu API de verdad (campos, sublistas y el primer registro).
Aplicar propuesta te deja elegir qué endpoints crear. Los modelos nuevos se crean a partir de los datos reales de cada endpoint; si la API no devuelve registros, se usan los campos que propuso la IA.
Ajustes de un endpoint
| Ajuste | Descripción |
|---|---|
| Tipo | Lectura (API → Tablifyx), envío (Tablifyx → API) o webhook (recibir eventos). |
| Método y ruta | GET /orders. En envíos admite {campo}: PUT /customers/{_external_id}. |
| Ruta de los registros | Dónde está la lista en la respuesta: data.items. Vacío = detección automática. |
| Campo único | Evita duplicados: si existe un registro con ese valor, se actualiza. Si no hay, se usa el id de la API. |
| Paginación | Ver tabla siguiente. |
| Consulta GraphQL | Para APIs GraphQL: la consulta con variables $first, $after (y $query para incremental). |
| Sincronización incremental | Parámetro (modified_after, updated_since…) y formato de fecha; se envía la fecha de la última sincronización correcta. Admite plantillas: updated_at:>'{since}'. |
| Sublistas | Listas dentro de cada registro (line_items, lineItems.nodes) que se guardan en un modelo hijo con relación al padre. Las líneas son únicas dentro de su registro padre. |
| Mapeo | Ruta en la API (con puntos) → campo de Tablifyx. |
Paginación
| Tipo | Opciones |
|---|---|
| Por página | param (page), size_param (per_page), size, start. Respeta X-WP-TotalPages. |
| Offset / limit | offset_param, size_param, size; o combined_param para el formato limit=offset,size (PrestaShop). |
| Cursor | param, cursor_path (ruta del siguiente cursor en la respuesta). |
| Último id | param (starting_after), has_more_path — estilo Stripe. |
| Enlace siguiente | next_path en el cuerpo, o cabecera Link: <…>; rel="next". |
| GraphQL | size, cursor_path, has_next_path (pageInfo). |
Si una API ignora la paginación y repite la misma página, Tablifyx lo detecta y se detiene.
Botones del endpoint: Sincronizar, Sincronización completa, Crear receptor de webhooks, Probar (muestra la respuesta real).