Primera Llamada API - Militant API

Guía para hacer tu primera llamada a la API Militant.

1. Verificar que la API funciona

curl https://tu-instancia.com/api/v1/

Deberías ver la lista de endpoints en JSON.

2. Autenticarse

curl -X POST https://tu-instancia.com/api/v1/auth.php \
  -H "Content-Type: application/json" \
  -d '{
    "username": "tu_usuario",
    "password": "tu_contraseña"
  }'

Respuesta:

{
  "success": true,
  "token": "abc123def456...",
  "expires_at": "2026-03-04 12:00:00",
  "user_id": 1
}

Copia el token, lo necesitarás para todas las llamadas siguientes.

3. Hacer una llamada autenticada

Obtener el feed de noticias

curl https://tu-instancia.com/api/v1/posts.php \
  -H "Authorization: Bearer TU_TOKEN"

Crear una publicación

curl -X POST https://tu-instancia.com/api/v1/posts.php \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "¡Mi primera publicación vía la API!"
  }'

Obtener tu perfil

curl https://tu-instancia.com/api/v1/users.php?username=tu_usuario \
  -H "Authorization: Bearer TU_TOKEN"

4. Manejar errores

Token inválido (401)

{
  "success": false,
  "error": "Invalid or expired token"
}

Solución: Inicia sesión nuevamente para obtener un nuevo token.

Límite de solicitudes excedido (429)

{
  "success": false,
  "error": "Rate limit exceeded"
}

Solución: Espera 1 hora o reduce el número de solicitudes.

Próximos pasos

Documentacion principal Volver a la API