Diferencia entre revisiones de «Módulo Drupal Guifi.net»

De Guifi.net - Wiki Hispano

(API)
(API)
Línea 27: Línea 27:
 
! Descripción
 
! Descripción
 
! Ejemplo
 
! Ejemplo
 +
|-
 +
| guifi.auth.login
 +
| Autentificar un usuario
 +
| http://guifi.net/api?command=guifi.auth.login&username=&password=
 +
|-
 +
| guifi.zone.add
 +
| Añadir una zona nueva
 +
| http://guifi.net/api?command=guifi.zone.add
 +
|-
 +
| guifi.zone.update
 +
| Actualizar una zona
 +
| http://guifi.net/api?command=guifi.zone.update
 +
|-
 +
| guifi.zone.remove
 +
| Borrar una zona
 +
| http://guifi.net/api?command=guifi.zone.remove
 +
|-
 +
| guifi.zone.nearest
 +
| Buscar la zona más cercana a un punto geográfico
 +
| http://guifi.net/api?command=guifi.zone.nearest
 
|-
 
|-
 
| guifi.node.add
 
| guifi.node.add
|
+
| Añadir un nodo nuevo
 
|
 
|
 
|-
 
|-
 
| guifi.node.update
 
| guifi.node.update
|
+
| Actualizar un nodo
 
|
 
|
 
|-
 
|-
 
| guifi.node.remove
 
| guifi.node.remove
|
+
| Borrar un nodo
 
|
 
|
 
|-
 
|-
 
| guifi.device.add
 
| guifi.device.add
|
+
| Añadir un nuevo dispositivo
 
|
 
|
 
|-
 
|-
 
| guifi.device.update
 
| guifi.device.update
|
+
| Actualizar un dispositivo
 
|
 
|
 
|-
 
|-
 
| guifi.device.remove
 
| guifi.device.remove
|
+
| Borrar un dispositivo
 
|
 
|
 
|-
 
|-
 
| guifi.radio.add
 
| guifi.radio.add
|
+
| Añadir una nueva radio
 
|
 
|
 
|-
 
|-
 
| guifi.radio.update
 
| guifi.radio.update
|
+
| Actualizar una radio
 
|
 
|
 
|-
 
|-
 
| guifi.radio.remove
 
| guifi.radio.remove
|
+
| Borrar una radio
 
|
 
|
 
|-
 
|-
 
| guifi.radio.nearest
 
| guifi.radio.nearest
|
+
| Buscar las radios en modo AP más cercanas a un nodo
 
|
 
|
 
|-
 
|-
 
| guifi.interface.add
 
| guifi.interface.add
|
+
| Añadir una nueva interfaz a una radio
 
|
 
|
 
|-
 
|-
 
| guifi.interface.remove
 
| guifi.interface.remove
|
+
| Borrar una interfaz de una radio
 
|
 
|
 
|-
 
|-
 
| guifi.link.add
 
| guifi.link.add
|
+
| Añadir un nuevo enlace entre dos interfaces
 
|
 
|
 
|-
 
|-
 
| guifi.link.update
 
| guifi.link.update
|
+
| Actualizar un enlace
 
|
 
|
 
|-
 
|-
 
| guifi.link.remove
 
| guifi.link.remove
|
+
| Borrar un enlace
 
|
 
|
 
|-
 
|-
 
| guifi.misc.model
 
| guifi.misc.model
|
+
| Obtener los modelos de dispositivos soportados en Guifi.net
 
|
 
|
 
|-
 
|-
 
| guifi.misc.manufacturer
 
| guifi.misc.manufacturer
|
+
| Obtener los fabricantes de dispositivos soportados en Guifi.net
 
|
 
|
 
|-
 
|-
 
| guifi.misc.firmware
 
| guifi.misc.firmware
|
+
| Obtener los firmwares de dispositivos soportados en Guifi.net
 
|
 
|
 
|-
 
|-
 
| guifi.misc.protocol
 
| guifi.misc.protocol
|
+
| Obtener los protocolos soportados en Guifi.net
 
|
 
|
 
|-
 
|-
 
| guifi.misc.channel
 
| guifi.misc.channel
|
+
| Obtener los canales de un protocolo soportados en Guifi.net
 
|
 
|
 
|}
 
|}

Revisión de 20:15 13 jul 2012

La web de Guifi.net funciona con el gestor de contenidos Drupal.

Para añadirle las funcionalidades de documentación de red libre se usa un módulo especial llamado drupal-guifi. Este módulo es software libre y está disponible en el repositorio de Gitorious[1].

La portada está diseñada mediante plantillas y se pueden encontrar en otro repositorio de Gitorious[2].

Historial de cambios

Características

API

El módulo Drupal Guifi.net implementa una API que permite a los desarrolladores crear aplicaciones externas que consulten y modifiquen la base de datos de Guifi.net. Las peticiones a la API se realizan mediante consultas de tipo GET del protocolo HTTP.

La documentación de dicha API se encuentra en el repositorio drupal-guifi, en la carpeta contrib/api_doc/[3] y en la url Documentació de l'API de guifi.net. También hay disponible una librería PHP para trabajar más cómodamente con la API. Se puede encontrar en la carpeta contrib/api_client/[4].

Las acciones posibles que se pueden realizar desde la API son las siguientes:


Comando Descripción Ejemplo
guifi.auth.login Autentificar un usuario http://guifi.net/api?command=guifi.auth.login&username=&password=
guifi.zone.add Añadir una zona nueva http://guifi.net/api?command=guifi.zone.add
guifi.zone.update Actualizar una zona http://guifi.net/api?command=guifi.zone.update
guifi.zone.remove Borrar una zona http://guifi.net/api?command=guifi.zone.remove
guifi.zone.nearest Buscar la zona más cercana a un punto geográfico http://guifi.net/api?command=guifi.zone.nearest
guifi.node.add Añadir un nodo nuevo
guifi.node.update Actualizar un nodo
guifi.node.remove Borrar un nodo
guifi.device.add Añadir un nuevo dispositivo
guifi.device.update Actualizar un dispositivo
guifi.device.remove Borrar un dispositivo
guifi.radio.add Añadir una nueva radio
guifi.radio.update Actualizar una radio
guifi.radio.remove Borrar una radio
guifi.radio.nearest Buscar las radios en modo AP más cercanas a un nodo
guifi.interface.add Añadir una nueva interfaz a una radio
guifi.interface.remove Borrar una interfaz de una radio
guifi.link.add Añadir un nuevo enlace entre dos interfaces
guifi.link.update Actualizar un enlace
guifi.link.remove Borrar un enlace
guifi.misc.model Obtener los modelos de dispositivos soportados en Guifi.net
guifi.misc.manufacturer Obtener los fabricantes de dispositivos soportados en Guifi.net
guifi.misc.firmware Obtener los firmwares de dispositivos soportados en Guifi.net
guifi.misc.protocol Obtener los protocolos soportados en Guifi.net
guifi.misc.channel Obtener los canales de un protocolo soportados en Guifi.net

Referencias

  1. http://gitorious.org/guifi/drupal-guifi
  2. http://gitorious.org/guifi/portada
  3. http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_doc
  4. http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_client

Véase también

Enlaces externos

Herramientas personales