Conector de datos#

El conector de datos rellena un sitio NAMES LEGAL con datos que ya existen en otro lugar, sin código por parte del propietario del sitio. El propietario conecta una fuente en su consola (Integraciones → Importar mis datos), enlaza columnas con campos arrastrando y soltando, realiza una prueba y lanza. Las fuentes pueden ser archivos o una API — la suya.

Esta página es para desarrolladores de aplicaciones que quieren ser una fuente: lo que NAMES LEGAL espera de su API, y cómo hacer que la conexión sea automática.

Cómo lee el conector su API#

El propietario del sitio introduce:

• la dirección de su API,
• un modo de autenticación y su secreto,
• opcionalmente, dónde está la lista en su respuesta (data.items).

NAMES LEGAL entonces llama a su API por HTTPS con GET, sigue la paginación, y convierte cada objeto en una ficha. Los objetos anidados se aplanan (author.name), las listas de valores simples se unen con comas.

Autenticación#

Los secretos se almacenan cifrados y nunca vuelven a mostrarse en la consola. Dé a los propietarios de sitios una clave de solo lectura limitada al contenido publicado: el conector solo lee.

Encontrar la lista#

Si no se indica ninguna ruta, el conector toma, en este orden: el array items, luego el primer array de objetos encontrado en la respuesta. Un array JSON simple también funciona.

Paginación#

Cualquiera de estos se sigue automáticamente, hasta 200 páginas:

• un encabezado HTTP Link: <…>; rel="next";
• una URL de página siguiente en el cuerpo: next, next_url, next_page_url, links.next, meta.next, pagination.next;
• un cursor en el cuerpo: next_cursor, meta.next_cursor, pagination.next_cursor — devuelto como ?cursor=.

Se detiene al devolver una lista vacía o ningún enlace siguiente.

Límites#

• 5000 fichas por conjunto de datos y sincronización.
• 10 MB por respuesta, 15 segundos por solicitud.
• Las direcciones deben ser públicas: se rechazan las direcciones privadas y de red local, redirecciones incluidas. En una redirección a otro host, su clave no se reenvía.

El formato de feed de NAMES LEGAL#

Exponga sus datos en este formato y el propietario del sitio no tendrá nada que enlazar: cada colección se convierte en un conjunto de datos ya conectado a la sección correspondiente del sitio.

1. Un índice#

GET https://app.example.com/api/names-legal/

{
  "names_legal_feed": 1,
  "collections": {
    "team": "https://app.example.com/api/names-legal/team/",
    "services": "https://app.example.com/api/names-legal/programmes/",
    "blog": "https://app.example.com/api/names-legal/news/"
  }
}

Los nombres de colección son las claves de sección listadas en la referencia de campos más abajo (team, services, blog, events, faq, jobs…). Las URL pueden ser relativas al índice.

2. Una lista por colección#

{
  "items": [
    {
      "id": "T-104",
      "first_name": "Awa",
      "last_name": "Diop",
      "position": "Mathematics teacher",
      "short_bio": "Twelve years of teaching.",
      "profile_image": "https://app.example.com/media/staff/104.jpg",
      "email": "a.diop@example.com"
    }
  ],
  "next": null
}

Reglas:

• id — un identificador estable, distinto en cada ficha. Es lo que permite que una ficha editada actualice la misma entrada en lugar de crear una nueva.
• Los nombres de campo son los de la referencia de campos.
• Los campos traducidos llevan una clave por idioma: title_fr, title_en, description_de… Una clave sin sufijo va al idioma predeterminado del sitio.
• Las imágenes y archivos son URL públicas. Se descargan una vez y vuelven a descargarse solo cuando la URL cambia. Se aceptan enlaces compartidos de Google Drive y Dropbox.
• Las categorías se indican por nombre ("category": "Bachelor"); las categorías inexistentes se crean.
• Las fechas están en ISO 8601. Los booleanos son true/false.
• Los campos de texto enriquecido aceptan HTML; se limpia (sin scripts, sin manejadores de eventos). El texto plano se convierte en párrafos.
• Devuelva solo lo que pueda publicarse: los borradores y los datos privados no deben aparecer en el feed.

Mantener el sitio actualizado#

El propietario del sitio elige, por sección:

También eligen qué ocurre cuando una ficha cambió en ambos lados (ganan sus datos, gana el sitio, o se pregunta), y cuándo una ficha desaparece de su feed (se elimina en el sitio, se oculta, o se conserva). Una sincronización que eliminaría una gran parte de una sección se detiene y pide confirmación primero.

Escribir de vuelta hacia su aplicación («mi sitio → mi fuente») todavía no está disponible: el conector solo lee.

Referencia de campos#

Generada desde la propia plataforma; siempre está actualizada. Los campos obligatorios deben estar presentes en cada ficha (para un campo traducido, en al menos un idioma).

Tamaño del equipo team

Servicios services

Proyectos projects

Blog / noticias blog

Eventos events

Preguntas frecuentes faq

Ofertas de empleo jobs

Recursos resources

Publicaciones publications

Testimonios testimonials

Habilidades skills

Cifras clave stats