Integrar con ayuda de una IA
Esta documentación está hecha para que la lea una persona y para que la lea un modelo. Si usas Claude, ChatGPT, Cursor o Copilot para escribir tu integración, dale estas direcciones en vez de pedirle que adivine.
Lo que puedes darle a tu asistente
| Dirección | Qué es |
|---|---|
https://docs.evetev.com/llms.txt |
El índice: qué hay y dónde, en texto plano. Es por donde debería empezar. |
https://docs.evetev.com/llms-full.txt |
Toda la documentación en un solo archivo. Para pegarlo en el contexto de una vez. |
https://docs.evetev.com/cobros.md |
Cualquier página, en Markdown crudo. Vale para todas: https://docs.evetev.com/empezar.md, https://docs.evetev.com/webhooks.md… |
https://docs.evetev.com/openapi.json |
La especificación de la API, generada desde el mismo contrato que valida las peticiones. |
Van con el dominio completo a propósito: una ruta suelta, pegada en un chat, no apunta a ninguna parte y el asistente se inventa el resto.
Para pegarle de una vez
Si no quieres pensarlo, esto le sirve a cualquier asistente:
Voy a integrar pagos con EvePay. La documentación está en https://docs.evetev.com/llms.txt
y toda junta en https://docs.evetev.com/llms-full.txt. Léela antes de escribir código: tiene
tres reglas que contradicen lo que hacen otras pasarelas.
Cada página del sitio tiene además un botón para copiarla en Markdown.
Por qué no es lo mismo que darle la página web
Una página HTML lleva navegación, estilos y estructura que el modelo tiene que descartar, y en el camino se pierden cosas: una tabla se aplana, un bloque de código se mezcla con el texto. El Markdown es lo mismo que lee la persona, sin el ruido.
Y hay una diferencia que importa más: estos archivos salen de la misma fuente que el sitio. No son una copia que alguien actualiza cuando se acuerda. Si cambian, cambian los dos.
Lo que conviene decirle
Tres cosas que un modelo acierta mal si nadie se las dice, porque son contrarias a lo que se ve en otras pasarelas:
- En pesos colombianos no hay centavos.
montoMinor: 89000son $ 89.000. Un modelo entrenado con Stripe multiplica por cien. - La llave va en el servidor. No hay snippet de JavaScript para el navegador. Si tu asistente te propone uno, está inventando.
- El pedido se despacha con el webhook, no cuando el comprador vuelve a tu página.
Comprueba lo que te escribió
Antes de mandar la primera petición de verdad, pásala por el ambiente de pruebas. Un cobro mal formado responde 400 con el detalle por campo, y eso es más rápido que leer el código generado línea por línea.