API de TOON Converter • TOON Converter

Resumen

La API de TOON Converter te permite convertir programáticamente entre formatos JSON y TOON (Token-Oriented Object Notation). TOON reduce el uso de tokens en un 30-60% en comparación con JSON, lo que lo hace ideal para aplicaciones de IA/LLM.

URL Base: https://toonverter.com/api

Endpoints

POST /api/convert

Convierte entre formatos JSON y TOON. Este endpoint valida la entrada y realiza la conversión.

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
`input_data`	string	Yes	The JSON or TOON string to convert
`direction`	string	Yes	Either `"json_to_toon"` or `"toon_to_json"`

Respuesta

{ "success": true, "output": "string - The converted output", "output_format": "json | toon", "message": "Conversion successful" }

Ejemplo: Convertir JSON a TOON

curl -X POST "https://toonverter.com/api/convert" \
  -H "Content-Type: application/json" \
  -d '{
    "input_data": "{\"name\": \"Alice\", \"age\": 30}",
    "direction": "json_to_toon"
  }'
                    

Ejemplo: Python

import requests

response = requests.post(
    "https://toonverter.com/api/convert",
    json={
        "input_data": '{"name": "Alice", "age": 30}',
        "direction": "json_to_toon"
    }
)
print(response.json())
                    

POST /api/validate

Valida la entrada JSON o TOON sin realizar la conversión. Útil para verificar la corrección del formato antes del procesamiento.

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
`input_data`	string	Yes	The JSON or TOON string to validate
`direction`	string	Yes	Either `"json_to_toon"` (validates JSON) or `"toon_to_json"` (validates TOON)

Respuesta

{ "valid": true, "message": "Input is valid" }

Ejemplo

curl -X POST "https://toonverter.com/api/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "input_data": "{\"name\": \"Alice\"}",
    "direction": "json_to_toon"
  }'
                    

GET /api/ai-tools

Obtén descripciones de herramientas amigables para IA para agentes de IA. Devuelve información estructurada sobre los endpoints de API disponibles en un formato optimizado para consumo de IA.

Note: This endpoint returns JSON. For human-readable documentation, see this page or visit /api/ai-tools.

Manejo de Errores

Todos los endpoints devuelven códigos de estado HTTP apropiados:

200 OK: Solicitud exitosa
400 Solicitud Incorrecta: Formato de entrada inválido (error de sintaxis JSON o TOON)
500 Error Interno del Servidor: Error inesperado del servidor

Las respuestas de error incluyen un campo detail con un mensaje de error descriptivo.

Acerca del Formato TOON

TOON (Token-Oriented Object Notation) es un formato de serialización compacto y legible por humanos diseñado para reducir el uso de tokens al pasar datos estructurados a Modelos de Lenguaje Grande (LLMs).

Beneficios

30-60% menos tokens en comparación con JSON
Formato legible por humanos
Soporta arrays tabulares para representación eficiente de datos
Estructura basada en indentación similar a YAML

Ejemplo

JSON:

{
  "users": [
    {"id": 1, "name": "Alice", "role": "admin"},
    {"id": 2, "name": "Bob", "role": "user"}
  ]
}
                        

TOON:

users[2]{id,name,role}:
  1,Alice,admin
  2,Bob,user
                        