Herramientas para desarrolladores
Netlify en tu producto y en tus agentes de IA, con una API
El toolkit de Netlify cubre sitios, deploys (listar, leer, compilar, cancelar y restaurar) y los formularios y envíos que recoge Netlify. Tu cliente conecta Netlify una vez con una API key, y tu producto o agente de IA llama a cada operación a través de Connect, que guarda las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/netlify_create_site_build/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"site_id": "<site_id>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Netlify.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Netlify. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Netlify.
Botón de deploy en tu CMS
Llama a Crear build del sitio cuando se publique contenido y sigue el deploy con Obtener deploy hasta que su state sea ready o error.
Rollback en una llamada
Restaura un deploy anterior para convertirlo en la versión en vivo del sitio cuando una publicación sale mal.
Formularios a tu bandeja o CRM
Lee los envíos de los formularios de un sitio y pásalos a tu producto, y elimina los envíos de spam.
Tools
11 tools de Netlify
- Listar sitiosGETLista los sitios (proyectos, en la interfaz de Netlify) a los que llega la cuenta, con id, nombre, url, custom_domain, el deploy publicado y la configuración de build. El id o el dominio de un sitio es el site_id que reciben las demás herramientas. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Actualizar sitioPATCHCambia el nombre o los dominios de un sitio y lo devuelve. Solo cambian los campos enviados. El DNS de un nuevo dominio personalizado aún debe apuntar a Netlify.
- Listar deploys del sitioGETLista los deploys de un sitio, del más reciente al más antiguo, con id, state, branch, context, error_message y la URL del deploy. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Obtener deployGETDevuelve un deploy, con state (ready cuando está en vivo o listo para publicar, error cuando el build falló), error_message, branch, commit_ref, published_at y la URL del deploy.
- Crear build del sitioPOSTInicia un build de un sitio desde el repositorio conectado y devuelve el build, con deploy_id para seguir en Obtener deploy. Sin branch, compila producción; otra branch genera un branch deploy. Espera en cola cuando el equipo no tiene capacidad de build libre.
- Cancelar deployPOSTDetiene un deploy que aún está en cola o compilándose y lo devuelve.
- Restaurar deploy del sitioPOSTPublica de nuevo un deploy anterior y lo convierte en la versión en vivo del sitio, que es como funciona un rollback. Devuelve el deploy.
- Listar formularios del sitioGETLista los formularios que Netlify detectó en un sitio, con id, nombre, campos y submission_count. Los envíos en sí vienen de Listar envíos de un formulario.
- Listar envíos del sitioGETLista los envíos de todos los formularios de un sitio, del más reciente al más antiguo, con nombre, email, los datos de cada campo y created_at. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Listar envíos de un formularioGETLista los envíos de un formulario, del más reciente al más antiguo, con nombre, email, los datos de cada campo y created_at. Pagina con page y per_page: una página con menos elementos que per_page es la última.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Netlify
¿Necesito implementar la API de Netlify?
No. Connect ya trae 11 tools de Netlify descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Netlify?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
