Herramientas para desarrolladores
Vercel en tu producto y en tus agentes de IA, con una API
El toolkit de Vercel cubre los equipos, proyectos, deployments y dominios de una cuenta Vercel: crear y actualizar proyectos, iniciar, cancelar y promover deployments, leer logs de build, y agregar y verificar dominios de proyectos. Con Connect, tu producto o agente de IA llama a estas operaciones por un solo endpoint, mientras Connect guarda el token y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/vercel_create_project/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Vercel.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Vercel. 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 Vercel.
Publicar sitios para tus usuarios
Crea un proyecto vinculado a un repositorio Git, inicia un deployment y síguelo con Get deployment hasta que cambie su readyState.
Dominios personalizados
Agrega el dominio de un cliente a un proyecto y lee la config de DNS para mostrar los valores recommendedIPv4 o recommendedCNAME que debe configurar.
Agente que arregla builds fallidos
Un agente de IA lee el log de build de un deployment fallido, encuentra la causa y promueve un deployment anterior para revertir la producción.
Tools
13 tools de Vercel
- Listar equiposGETLista los equipos a los que pertenece la cuenta. Cada elemento tiene id, el teamId que usan las otras tools, y slug. Solo un token de Full Account necesita teamId: un token creado para un equipo ya actúa en ese equipo. Pagina pasando pagination.next de la respuesta como until.
- Listar proyectosGETLista los proyectos de la cuenta o de un equipo, con sus ajustes, vínculo con Git y últimos deployments. Cada elemento tiene id y name, que las otras tools usan como el proyecto. Pagina pasando pagination.next de la respuesta como from.
- Crear proyectoPOSTCrea un proyecto y lo devuelve, con su id. Con gitRepository, cada push al repositorio hace deploy automáticamente; la app de Vercel del proveedor Git debe tener acceso al repositorio. Los ajustes de build omitidos los detecta Vercel.
- Actualizar proyectoPATCHCambia el nombre o los ajustes de build de un proyecto y lo devuelve. Solo cambian los campos enviados. Los nuevos ajustes se aplican desde el próximo deployment.
- Listar deploymentsGETLista deployments, del más nuevo al más antiguo, con state, target, url y metadatos de Git. Cada elemento tiene uid, el id del deployment. Pagina pasando pagination.next de la respuesta como until.
- Obtener deploymentGETDevuelve un deployment por su id o su url, con readyState, target, alias, projectId y, para un build fallido, errorCode y errorMessage.
- Crear deploymentPOSTInicia un deployment y lo devuelve, con id, url y readyState. Envía deploymentId para volver a desplegar un deployment existente, o gitSource para desplegar una rama o commit del repositorio conectado. Sin target es un preview; production lo convierte en el deployment de producción. El build tarda minutos: síguelo con Get deployment.
- Cancelar deploymentPATCHDetiene un deployment que sigue en cola o en build y lo devuelve con readyState CANCELED.
- Promover deploymentPOSTApunta los dominios de producción de un proyecto a un deployment existente, sin volver a hacer el build, por ejemplo para revertir la producción a un deployment de producción anterior. Para poner un preview en producción con un nuevo build, usa Create deployment con su deploymentId y target production. Responde 201 o 202 cuando se acepta.
- Listar eventos del deploymentGETDevuelve el log de build de un deployment como una lista de eventos, cada uno con type (como stdout, stderr o command), created y el texto de la línea. Úsalo para ver por qué falló un build.
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 Vercel
¿Necesito implementar la API de Vercel?
No. Connect ya trae 13 tools de Vercel 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 Vercel?
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.
