Documentación API
La API de Raisetalk en formato OpenAPI: documentación generada desde el código y generación de un SDK cliente en el lenguaje que elija.
La documentación completa está disponible en la aplicación Raisetalk. Abrir la documentación en la aplicación
Documentación OpenAPI
La documentación completa de la API de Raisetalk está disponible en formato OpenAPI en la siguiente dirección: https://api.raisetalk.com/docs.
Se genera automáticamente a partir del código fuente de la API y se actualiza en cada despliegue, lo que garantiza que siempre refleje fielmente el comportamiento real de los endpoints expuestos.
El archivo de especificación en bruto también está accesible en https://api.raisetalk.com/openapi.yaml.
Generar un SDK
A partir de esta especificación OpenAPI, es fácil generar un SDK cliente en prácticamente cualquier lenguaje (PHP, Python, TypeScript, Java, Go, Ruby, C#, etc.) mediante la herramienta openapi-generator-cli.
Ejemplo para generar un SDK PHP:
docker run --rm \
-v "${PWD}:/local" \
openapitools/openapi-generator-cli generate \
-i https://api.raisetalk.com/openapi.yaml \
-g php \
-o /local/sdk/php
Para cambiar el lenguaje de destino, basta con modificar el valor del parámetro -g (por ejemplo -g python, -g typescript-axios, -g java, etc.).
La lista completa de generadores disponibles y la documentación detallada de la herramienta están disponibles en el sitio oficial: https://openapi-generator.tech/.