{% blocktranslate %} Galería incluye una API REST muy simple para poder consultar y modificar la galería en línea; en general, las operaciones de consulta no requieren de autenticación; mientras que todas las operaciones para modificar la galería sí la requieren, utilizando la ficha (token) de usuario en Django, que se muestra automáticamente en la entrada Información del menú. {% endblocktranslate %}
{% translate "Listar álbumes" %}
{% blocktranslate %} Regresa un listado de todos las álbumes y sus propiedades en la galería, en formato JSON. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: list_albums
- Parámetros: Ninguno
- Autenticación: No
- Uso:
{% endblocktranslate %}
curl {{galeria_url}}/rest/list_albums
{% translate "Listar fotos" %}
{% blocktranslate %} Regresa un listado de todas las fotos y sus propiedades en la galería, en formato JSON. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: list_photos
- Parámetros: Ninguno
- Autenticación: No
- Uso:
{% endblocktranslate %}
curl {{galeria_url}}/rest/list_photos
{% translate "Foto aleatoria" %}
{% blocktranslate %} Regresa información suficiente de una foto aleatoria en la galería para que pueda ser desplegada en otro sitio. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: random_photo
- Parámetros: Ninguno
- Autenticación: No
- Uso:
{% endblocktranslate %}
curl {{galeria_url}}/rest/random_photo
{% translate "Cargar fotos" %}
{% blocktranslate %} Carga una o más fotos a la galería. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: upload_photos
- Parámetros: Uno o múltiples archivos en el campo fields de una forma POST
- Autenticación: Sí
- Uso:
{% endblocktranslate %}
# Subir una imagen curl -H 'Authorization: Token {{token}}' \ -X POST -F "files=@image.jpg" \ {{galeria_url}}/rest/upload_photo
# Subir múltiples imágenes curl -H 'Authorization: Token {{token}}' \ -X POST -F "files=@image1.jpg" -F "files=@image2.jpg" ... \ {{galeria_url}}/rest/upload_photos
{% translate "Eliminar elemento" %}
{% blocktranslate %} Elimina un un elemento de la galería; si el elemento es un álbum, todos los subálbumes y fotos dentro del álbum son eliminados también. {% endblocktranslate %}
{% blocktranslate %} Advertencia: Esta operación es destructiva; una vez una foto ha sido eliminada, la única forma de recuperarla es cargarla de nuevo. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: delete_item
- Parámetros: La ruta a un elemento de la galería
- Autenticación: Sí
- Uso:
{% endblocktranslate %}
curl -H 'Authorization: Token {{token}}' \ {{galeria_url}}/rest/delete_item?path={{galeria.now_year}}/
{% translate "Restablecer elementos destacados" %}
{% blocktranslate %} Restablece los elementos destacados de la galería. Al restablecer los elementos destacados, la primera foto de un evento se vuelve el elemento destacado; y el primer álbum de un mes o año se vuelve el elemento destacado del álbum que los contenga. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: reset_highlights
- Parámetros: Ninguno
- Autenticación: Sí
- Uso:
{% endblocktranslate %}
curl -H 'Authorization: Token {{token}}' \ {{galeria_url}}/rest/reset_highlights
{% translate "Descargar elementos destacados" %}
{% blocktranslate %} Descarga los elementos destacados de la galería, en un archivo con formato JSON. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: get_highlights
- Parámetros: Ninguno
- Autenticación: No
- Uso:
{% endblocktranslate %}
curl {{galeria_url}}/rest/get_highlights
{% translate "Cargar elementos destacados" %}
{% blocktranslate %} Carga los elementos destacados en la galería, desde un archivo con formato JSON. {% endblocktranslate %}
-
{% blocktranslate %}
- Método: set_highlights
- Parámetros: El archivo JSON con los elementos destacados
- Autenticación: No
- Uso:
{% endblocktranslate %}
curl -H 'Authorization: Token {{token}}' \ -H 'Content-Type: application/json' -d@highlights.json \ {{galeria_url}}/rest/set_highlights