GW
Good Wiki

API de Good Wiki

🚀 API RESTful

Good Wiki proporciona una API RESTful para acceso programático a todo el contenido. Perfecta para integraciones, aplicaciones móviles y herramientas de investigación.

Información General

Base URL

https://api.goodwiki.eu/v1

Formato

JSON

Todas las respuestas en JSON

Autenticación

API Key

Requerida para algunas operaciones

Endpoints Principales

Artículos

GET

Obtener todos los artículos

GET /articles

Parámetros: page, limit, search, category

Obtener artículo específico

GET /articles/{slug}

Devuelve el contenido completo del artículo

Categorías

GET

Listar categorías

GET /categories

Artículos por categoría

GET /categories/{slug}/articles

Búsqueda

GET

Buscar contenido

GET /search?q={query}

Búsqueda de texto completo en títulos y contenido

Ejemplos de Uso

JavaScript/Node.js

// Obtener artículos
const response = await fetch('https://api.goodwiki.eu/v1/articles', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const articles = await response.json();
console.log(articles);

Python

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.goodwiki.eu/v1/articles',
    headers=headers
)

articles = response.json()
print(articles)

cURL

curl -X GET "https://api.goodwiki.eu/v1/articles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Respuesta de Ejemplo

{
  "data": [
    {
      "id": 1,
      "slug": "historia-espana",
      "title": "Historia de España",
      "excerpt": "Breve resumen del artículo...",
      "content": "Contenido completo del artículo...",
      "author": "Comunidad Good Wiki",
      "published_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-01-20T14:30:00Z",
      "category": "Historia",
      "tags": ["españa", "historia", "europa"],
      "views": 1250,
      "word_count": 3500
    }
  ],
  "meta": {
    "total": 150,
    "page": 1,
    "per_page": 10,
    "total_pages": 15
  }
}

Límites y Uso Responsable

⚠️ Límites de la API

• 1000 requests por hora para usuarios autenticados

• 100 requests por hora para usuarios anónimos

• Máximo 100 resultados por página

• No spam ni uso abusivo

Obtener una API Key

Para obtener una API key y acceso completo:

  1. 1. Contacta con nosotros describiendo tu uso previsto
  2. 2. Proporciona información sobre tu aplicación/proyecto
  3. 3. Acepta los términos de uso de la API
  4. 4. Recibe tu API key por email

Códigos de Estado HTTP

200 OKSolicitud exitosa
400 Bad RequestParámetros inválidos
401 UnauthorizedAPI key inválida
404 Not FoundRecurso no encontrado
429 Too Many RequestsLímite de requests excedido

Soporte y Comunidad

Para preguntas, reportar bugs o sugerir mejoras:

🔧 ¿Necesitas funcionalidad específica?

Estamos ampliando constantemente la API. Si necesitas endpoints específicos o funcionalidades adicionales, háznoslo saber y evaluaremos incluirlo en futuras versiones.