Documentacion de la API
Integra Shortway en tu sitio web. Genera contenido con IA, gestiona contactos y automatiza tu marketing.
Introduccion
La Blog API de Shortway permite integrar un sistema de blog completo en tu sitio web. Con ella puedes:
- Crear, leer, actualizar y eliminar posts
- Generar contenido automaticamente con IA
- Recibir notificaciones via webhooks
- Automatizar tu estrategia de contenido SEO
Base URL
https://app.shortway.com.mx/api/v1/blogAutenticacion
La API utiliza un sistema de doble clave:
| Tipo | Prefijo | Uso |
|---|---|---|
| Public Key | sw_pub_ | Operaciones de lectura (GET) |
| Private Key | sw_prv_ | Escritura (POST, PUT, DELETE) |
X-API-Key: sw_pub_xxxxxImportante: Nunca expongas tu Private Key en codigo frontend. Usala solo en tu servidor.
Endpoints
| Metodo | Endpoint | Descripcion |
|---|---|---|
| GET | /posts | Listar posts |
| GET | /posts/:slug | Obtener post por slug |
| POST | /posts | Crear post |
| POST | /posts/generate | Generar post con IA |
| PUT | /posts/:id | Actualizar post |
| DELETE | /posts/:id | Eliminar post |
| GET | /tags | Listar tags |
| GET | /categories | Listar categorias |
Posts
Listar Posts
GET /posts?status=published&limit=10&page=1Parametros: status, tag, category, search, page, limit
Respuesta
{
"posts": [{
"id": "uuid",
"slug": "mi-post",
"title": "Mi Post",
"excerpt": "Resumen...",
"content_html": "<h1>Contenido</h1>",
"featured_image": "https://...",
"tags": ["seo"],
"status": "published",
"published_at": "2026-01-21T09:00:00Z"
}],
"pagination": {
"page": 1,
"total": 45,
"hasMore": true
}
}Crear Post
POST /posts
{
"title": "Mi Nuevo Post",
"content": "# Contenido en Markdown...",
"tags": ["tag1", "tag2"],
"status": "draft"
}Generacion con IA
Genera articulos completos automaticamente.
POST /posts/generate
{
"topic": "Como mejorar el SEO",
"keywords": ["SEO", "Google"],
"tone": "professional",
"language": "es",
"wordCountTarget": 1500,
"generateImage": true
}Tonos disponibles: professional, casual, technical, educational
Webhooks
Recibe notificaciones cuando se publique contenido.
{
"event": "blog_post.published",
"post": {
"id": "uuid",
"slug": "mi-post",
"title": "Titulo"
},
"timestamp": "2026-01-21T09:00:00Z"
}Verifica el header X-Shortway-Secret en cada request.
Ejemplos
Next.js
const res = await fetch(
'https://app.shortway.com.mx/api/v1/blog/posts',
{
headers: { 'X-API-Key': process.env.SHORTWAY_KEY },
next: { revalidate: 3600 }
}
);
const { posts } = await res.json();cURL
curl -X GET "https://app.shortway.com.mx/api/v1/blog/posts" \
-H "X-API-Key: sw_pub_xxxxx"Codigos de Error
400 | Parametros invalidos |
401 | API Key invalida |
404 | Recurso no encontrado |
429 | Rate limit excedido |
¿Necesitas ayuda?
Si tienes preguntas sobre la API o necesitas soporte tecnico, estamos aqui para ayudarte.