API de Clipzi y recursos para desarrolladores

Todo lo programatico de Clipzi en un solo lugar: que existe hoy, cuales son los contratos y como contactarnos si necesitas mas.

Estado de la API

La API de producto de Clipzi (subida, analisis, exporte de clips) hoy requiere una sesion autenticada de navegador y todavia no esta abierta para uso programatico. La superficie publica documentada es el endpoint de contacto y los recursos legibles por maquinas de abajo. Si queres acceso a la API para tu caso de uso, contanos por el endpoint de contacto o a g@clipzi.app.

Especificacion OpenAPI

La descripcion legible por maquinas de la superficie HTTP publica vive en https://clipzi.app/openapi.json. Documenta cada endpoint, schema, envelope de errores y las politicas de esta pagina.

Politica de versionado y deprecacion

• La API se versiona por path de URL: /api/v1/... es la version actual.
• Los paths sin version (como /api/contact) son alias de la version actual.
• Los cambios incompatibles solo salen en una nueva version de path (/api/v2/); el comportamiento de v1 nunca cambia.
• Antes de remover un endpoint, sus respuestas llevan headers Deprecation y Sunset (RFC 8594) por al menos 90 dias, y el spec OpenAPI se actualiza con el reemplazo.

Servidor MCP

Un servidor MCP (Model Context Protocol) de solo lectura corre en https://clipzi.app/api/mcp con transporte Streamable HTTP, stateless y sin auth. Expone tres tools: get_product_info, get_pricing y get_developer_docs. El manifest de descubrimiento vive en https://clipzi.app/mcp.json.

Rate limits

Las respuestas de la API llevan headers RateLimit del IETF para que los clientes puedan autorregularse en tiempo real: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (segundos hasta que resetea la ventana) y RateLimit-Policy (limite;w=segundosDeVentana). Superar un limite devuelve HTTP 429 con header Retry-After y un body JSON de error. Limites actuales:

• Endpoint de contacto: 10 requests por minuto por IP.
• Endpoint MCP: 60 requests por minuto por IP.
• Otros paths /api/*: 120 requests por minuto por IP.

Errores

Todos los errores de la API son JSON, nunca HTML. Los paths /api/* desconocidos devuelven HTTP 404 con un envelope estructurado: un objeto error con code, message y un hint apuntando al siguiente paso.

Recursos legibles por maquinas

• Spec OpenAPI: https://clipzi.app/openapi.json
• Resumen del sitio para agentes (llms.txt): https://clipzi.app/llms.txt
• Precios en markdown: https://clipzi.app/pricing.md
• Sitemap: https://clipzi.app/sitemap.xml

Negociacion de contenido markdown

El homepage y esta pagina sirven una variante markdown a los clientes que la piden con Accept: text/markdown (las respuestas varian por Accept). Los navegadores siguen recibiendo HTML; los agentes que prefieren markdown reciben markdown en la misma URL.

Contacto

Soporte, partnerships o pedidos de acceso a la API: POST /api/v1/contact (ver el spec) o escribi a g@clipzi.app.