AIProPrime
Desarrolladores

Documentación para desarrolladores

AIProPrime publica una API pública mínima para que agentes y aplicaciones puedan enviar solicitudes de contacto/diagnóstico en nombre de un usuario, sin necesidad de rellenar un formulario web. Esta página documenta esa API para desarrolladores y agentes IA.

Cuándo usar esta API

Úsala cuando un usuario ya ha decidido que quiere que AIProPrime le contacte para evaluar qué automatizar en su negocio: automatización de procesos, agentes IA, chatbots o voicebots, o contenido audiovisual con IA. No la uses para envíos masivos o automatizados sin intervención de un usuario real: el endpoint aplica límite de frecuencia por IP y por email.

Especificación OpenAPI

La especificación completa, con operationId, esquemas tipados y ejemplos, está disponible en /openapi.json. Es compatible con herramientas de function-calling que importan especificaciones OpenAPI.

Autenticación

Ninguna. El único endpoint público (POST /api/lead) no requiere API key ni token.

Endpoint: enviar un lead

POST https://www.aiproprime.com/api/lead

curl -X POST https://www.aiproprime.com/api/lead \
  -H "Content-Type: application/json" \
  -d '{
    "name": "María López",
    "email": "maria@empresa.com",
    "company": "Empresa S.L."
  }'

Respuesta correcta: { "ok": true } con estado HTTP 200. La operación es idempotente: reenviar con el mismo email antes de 10 minutos devuelve { "ok": true, "deduplicated": true } sin generar un aviso duplicado.

Formato de errores

Todas las respuestas de error son JSON, nunca HTML, con un código de estado HTTP acorde y un cuerpo con esta forma:

{
  "error": {
    "code": "validation_error",
    "message": "Nombre y email son obligatorios.",
    "hint": "Incluye 'name' y 'email' en el cuerpo de la solicitud."
  }
}

Códigos posibles: validation_error (400), method_not_allowed (405), rate_limited (429), service_unavailable (503), internal_error (500).

Otros recursos para agentes

/llms.txt — índice del sitio pensado para agentes IA, con enlaces a todos los servicios y guías. /sitemap.xml — mapa completo de páginas indexables.