SDKs Oficiales de Militant

Los SDKs oficiales permiten integrar la API de Militant rapidamente en proyectos Python y JavaScript/Node.js.

Para que sirven

• lanzar rapidamente un bot, un worker o un script de automatizacion
• conectar Militant a una aplicacion Python, Node.js o React Native
• usar los endpoints sin reescribir toda la capa HTTP y de autenticacion
• construir herramientas de administracion, moderacion o exportacion

SDKs disponibles

SDK Python

• Archivo: militant.py
• Documentacion: README Python en GitLab
• Dependencias: requests
• Uso: scripts, bots, aplicaciones backend Python

SDK JavaScript

• Archivo: militant.js
• Documentacion: README JavaScript en GitLab
• Dependencias: axios
• Uso: Node.js, aplicaciones web, React Native

Bots y automatizacion

• Ejemplo incluido: Keyword Relay Bot
• Ruta: examples/bots/keyword-relay-bot
• Uso: vigilancia tematica, retransmision de alertas, moderacion ligera, flujos de cuenta operadora

Instalacion rapida

Python

mkdir -p vendor/militant-sdk
curl -fsSLo vendor/militant-sdk/militant.py https://gitlab.com/militant1/militant-api/-/raw/main/sdk/python/militant.py
pip install requests

JavaScript

mkdir -p vendor/militant-sdk
curl -fsSLo vendor/militant-sdk/militant.js https://gitlab.com/militant1/militant-api/-/raw/main/sdk/javascript/militant.js
npm install axios

Integracion rapida

Python

import sys
sys.path.append('./vendor/militant-sdk')
from militant import MilitantClient

JavaScript

const MilitantClient = require('./vendor/militant-sdk/militant');

Si prefieres una estructura muy simple, coloca militant.py o militant.js directamente en la raiz del proyecto.

Ejemplo de uso

Python

from militant import MilitantClient
client = MilitantClient('https://militant.revlibertaire.com')
user = client.login('username', 'password')
timeline = client.get_timeline()
post = client.create_post('Hello from Python!')

JavaScript

const MilitantClient = require('./militant');
(async () => {
  const client = new MilitantClient('https://militant.revlibertaire.com');
  const user = await client.login('username', 'password');
  const timeline = await client.getTimeline();
  const post = await client.createPost('Hello from JavaScript!');
})();

Funcionalidades cubiertas

Los dos SDKs cubren una gran parte de la API y sirven como capa principal de integracion para los usos corrientes:

Autenticacion

• login/logout con token JWT
• refresco de token
• revocacion de token

Contenido social

• posts, comentarios y reacciones
• likes, compartidos y marcadores
• stories
• traduccion multilingue

Usuarios y relaciones

• perfiles de usuario
• seguidores y seguidos
• solicitudes de amistad
• mensajes privados
• grupos de mensajes

Grupos y paginas

• creacion y gestion de grupos
• posts y comentarios de grupo
• creacion y gestion de paginas
• posts de pagina

Medios y eventos

• subida de medios
• albumes de fotos
• lives streaming
• eventos

Moderacion y seguridad

• reportes
• votos de moderadores
• sanciones
• 2FA
• preferencias de usuario
• exportacion de datos

Llamadas de audio y video (solo Flutter)

• llamadas audio/video uno a uno
• llamadas de grupo
• signaling WebRTC a traves de la API
• ICE restart para movilidad de red
• Nota: requiere el header X-Flutter-App: militant-flutter-v1

Nota:

• algunos endpoints muy recientes pueden aparecer en la API antes de estar expuestos en ambos SDKs
• estos SDKs deben verse como la capa principal de integracion, pero no como una cobertura inmediata del 100%

Documentacion detallada

• Documentacion Python - guia completa con ejemplos Python
• Documentacion JavaScript - guia completa con ejemplos JavaScript
• Endpoints API - lista de todos los endpoints disponibles

Seguridad

• todas las llamadas deben usar HTTPS
• autenticacion por token JWT
• rate limiting automatico
• soporte 2FA
• manejo seguro de tokens

Soporte multilingue

La API y los SDKs soportan:

• Frances
• Ingles
• Espanol
• Esperanto

Casos de uso

Bot de moderacion

client = MilitantClient('https://militant.revlibertaire.com')
client.login('bot_username', 'bot_password')
reports = client.get_reports()
for report in reports['data']:
    if report['reason'] == 'spam':
        client.vote_on_report(report['id'], 'approve')

Aplicacion web

const client = new MilitantClient('https://militant.revlibertaire.com');
await client.login(username, password);
const timeline = await client.getTimeline(1, 20);
displayPosts(timeline.posts);

Script de exportacion

client = MilitantClient('https://militant.revlibertaire.com')
client.login('username', 'password')
data = client.export_data()

Reportar un bug

Abre un issue en GitLab:

• militant-api

Contribucion

Las contribuciones son bienvenidas: 1. Haz un fork del proyecto en GitLab 2. Crea una rama de funcionalidad 3. Haz commit de tus cambios 4. Sube la rama 5. Abre una merge request

Licencia

Los SDKs se distribuyen bajo la misma licencia que la API de Militant. Consulta LICENSE en la raiz del proyecto.

Enlaces utiles

• Inicio del wiki
• Instalacion de la API
• Primera llamada API
• Lista de endpoints
• FAQ

---