photoprism/internal/api/photos.go

package api

import (
	"log"
	"net/http"
	"strconv"

	"github.com/gin-gonic/gin"
	"github.com/gin-gonic/gin/binding"
	"github.com/photoprism/photoprism/internal/forms"
	"github.com/photoprism/photoprism/internal/photoprism"
)

// `GET /api/v1/photos`
//
// Query:
//   - `q`: string Query string            `form:""`
//	 - `tags`: string Tags          string    `form:"tags"`
//	 - `cat`: string Category
//	 - `country`: string Country code
//	 - `camera`: int Camera ID
//	 - `order`: string Sort order
//	 - `count`: int Max result count (required)
//	 - `offset`: int Result offset
//	 - `before`: date Find photos taken before (format: "2006-01-02")
//	 - `after`: date Find photos taken after (format: "2006-01-02")
//	 - `favorites`: bool Find favorites only
func GetPhotos(router *gin.RouterGroup, conf *photoprism.Config) {
	router.GET("/photos", func(c *gin.Context) {
		var form forms.PhotoSearchForm

		search := photoprism.NewSearch(conf.OriginalsPath, conf.GetDb())

		c.MustBindWith(&form, binding.Form)

		result, err := search.Photos(form)

		if err != nil {
			c.AbortWithStatusJSON(400, gin.H{"error": err.Error()})
		}

		c.Header("x-result-count", strconv.Itoa(form.Count))
		c.Header("x-result-offset", strconv.Itoa(form.Offset))

		c.JSON(http.StatusOK, result)
	})
}

// `POST /api/v1/photos/:photoId/like`
//
// Parameters:
//   - `photoId`: Photo ID as returned by the API
func LikePhoto(router *gin.RouterGroup, conf *photoprism.Config) {
	router.POST("/photos/:photoId/like", func(c *gin.Context) {
		search := photoprism.NewSearch(conf.OriginalsPath, conf.GetDb())

		photoId, err := strconv.ParseUint(c.Param("photoId"), 10, 64)

		if err == nil {
			photo := search.FindPhotoByID(photoId)
			photo.PhotoFavorite = true
			conf.GetDb().Save(&photo)
			c.JSON(http.StatusAccepted, http.Response{})
		} else {
			log.Printf("could not find image for id: %s", err.Error())
			c.Data(http.StatusNotFound, "image", []byte(""))
		}
	})
}

// `DELETE /api/v1/photos/:photoId/like`
//
// Parameters:
//   - `photoId`: Photo ID as returned by the API
func DislikePhoto(router *gin.RouterGroup, conf *photoprism.Config) {
	router.DELETE("/photos/:photoId/like", func(c *gin.Context) {
		search := photoprism.NewSearch(conf.OriginalsPath, conf.GetDb())

		photoId, err := strconv.ParseUint(c.Param("photoId"), 10, 64)

		if err == nil {
			photo := search.FindPhotoByID(photoId)
			photo.PhotoFavorite = false
			conf.GetDb().Save(&photo)
			c.JSON(http.StatusAccepted, http.Response{})
		} else {
			log.Printf("could not find image for id: %s", err.Error())
			c.Data(http.StatusNotFound, "image", []byte(""))
		}
	})
}