first commit
This commit is contained in:
luoyangwei
@@ -0,0 +1 @@
|
||||
<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>
|
||||
|
After Width: | Height: | Size: 391 B |
@@ -0,0 +1 @@
|
||||
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>
|
||||
|
After Width: | Height: | Size: 1.0 KiB |
@@ -0,0 +1 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>
|
||||
|
After Width: | Height: | Size: 1.3 KiB |
@@ -0,0 +1,37 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<title>Wallora Searcher API Docs</title>
|
||||
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css" />
|
||||
<style>
|
||||
body {
|
||||
margin: 0;
|
||||
background: #ffffff;
|
||||
}
|
||||
.swagger-ui .topbar {
|
||||
display: none;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div id="swagger-ui"></div>
|
||||
<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
|
||||
<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-standalone-preset.js"></script>
|
||||
<script>
|
||||
window.addEventListener("load", () => {
|
||||
window.ui = SwaggerUIBundle({
|
||||
url: "/swagger.yaml",
|
||||
dom_id: "#swagger-ui",
|
||||
deepLinking: true,
|
||||
presets: [
|
||||
SwaggerUIBundle.presets.apis,
|
||||
SwaggerUIStandalonePreset
|
||||
],
|
||||
layout: "StandaloneLayout"
|
||||
});
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,590 @@
|
||||
openapi: 3.1.0
|
||||
info:
|
||||
title: Wallora Searcher API
|
||||
version: 0.1.0
|
||||
description: Public API contract for Wallora Searcher.
|
||||
servers:
|
||||
- url: /api/v1
|
||||
description: Local Next.js API route base
|
||||
paths:
|
||||
/auth/login:
|
||||
post:
|
||||
summary: Login app user with email and password
|
||||
requestBody:
|
||||
required: true
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
required:
|
||||
- email
|
||||
- password
|
||||
properties:
|
||||
email:
|
||||
type: string
|
||||
format: email
|
||||
password:
|
||||
type: string
|
||||
responses:
|
||||
"200":
|
||||
description: App user token and profile.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
$ref: "#/components/schemas/AuthResponse"
|
||||
"401":
|
||||
description: Invalid email or password, or the app user is disabled.
|
||||
/auth/register:
|
||||
post:
|
||||
summary: Register app user with email and password
|
||||
requestBody:
|
||||
required: true
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
required:
|
||||
- email
|
||||
- password
|
||||
properties:
|
||||
email:
|
||||
type: string
|
||||
format: email
|
||||
password:
|
||||
type: string
|
||||
minLength: 8
|
||||
displayName:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
responses:
|
||||
"200":
|
||||
description: App user token and profile.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
$ref: "#/components/schemas/AuthResponse"
|
||||
"400":
|
||||
description: Invalid request or duplicate email.
|
||||
/gallery/collections:
|
||||
get:
|
||||
summary: List published photo collections
|
||||
description: Returns published photo collections with cover metadata.
|
||||
parameters:
|
||||
- name: page
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
default: 1
|
||||
- name: pageSize
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
maximum: 50
|
||||
default: 20
|
||||
responses:
|
||||
"200":
|
||||
description: Paginated published collections.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
type: array
|
||||
items:
|
||||
$ref: "#/components/schemas/PhotoCollection"
|
||||
pagination:
|
||||
$ref: "#/components/schemas/Pagination"
|
||||
/gallery/collections/{slug}:
|
||||
get:
|
||||
summary: Get a published photo collection
|
||||
description: Returns collection metadata and paginated picked photos in collection order.
|
||||
parameters:
|
||||
- name: slug
|
||||
in: path
|
||||
required: true
|
||||
schema:
|
||||
type: string
|
||||
- name: page
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
default: 1
|
||||
- name: pageSize
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
maximum: 100
|
||||
default: 24
|
||||
responses:
|
||||
"200":
|
||||
description: Published collection with paginated photos.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
type: object
|
||||
properties:
|
||||
collection:
|
||||
$ref: "#/components/schemas/PhotoCollection"
|
||||
photos:
|
||||
type: array
|
||||
items:
|
||||
$ref: "#/components/schemas/PickedGalleryPhoto"
|
||||
pagination:
|
||||
$ref: "#/components/schemas/Pagination"
|
||||
"404":
|
||||
description: Collection was not found or is not published.
|
||||
/gallery/photos:
|
||||
get:
|
||||
summary: List picked gallery photos
|
||||
description: Returns public picked photos for waterfall-style infinite scroll. If a Bearer JWT is provided, each photo includes current user's favorite state.
|
||||
security:
|
||||
- {}
|
||||
- bearerAuth: []
|
||||
parameters:
|
||||
- name: page
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
default: 1
|
||||
- name: pageSize
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
maximum: 100
|
||||
default: 24
|
||||
- name: colorFamily
|
||||
in: query
|
||||
schema:
|
||||
type: string
|
||||
enum:
|
||||
- all
|
||||
- black
|
||||
- blue
|
||||
- green
|
||||
- light
|
||||
- orange
|
||||
- purple
|
||||
- red
|
||||
- yellow
|
||||
responses:
|
||||
"200":
|
||||
description: Paginated picked photos.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
type: array
|
||||
items:
|
||||
$ref: "#/components/schemas/PickedGalleryPhoto"
|
||||
pagination:
|
||||
$ref: "#/components/schemas/Pagination"
|
||||
/gallery/photos/{id}:
|
||||
get:
|
||||
summary: Get picked photo detail
|
||||
description: Returns one picked photo by id. If a Bearer JWT is provided, includes current user's favorite state.
|
||||
security:
|
||||
- {}
|
||||
- bearerAuth: []
|
||||
parameters:
|
||||
- name: id
|
||||
in: path
|
||||
required: true
|
||||
schema:
|
||||
type: string
|
||||
format: uuid
|
||||
responses:
|
||||
"200":
|
||||
description: Picked photo detail.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
$ref: "#/components/schemas/PickedGalleryPhoto"
|
||||
"404":
|
||||
description: Photo was not found or is not picked.
|
||||
post:
|
||||
summary: Favorite picked photo
|
||||
description: Adds the photo to the current user's favorites.
|
||||
security:
|
||||
- bearerAuth: []
|
||||
parameters:
|
||||
- name: id
|
||||
in: path
|
||||
required: true
|
||||
schema:
|
||||
type: string
|
||||
format: uuid
|
||||
responses:
|
||||
"200":
|
||||
description: Favorited photo.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
$ref: "#/components/schemas/FavoritePhoto"
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
delete:
|
||||
summary: Unfavorite picked photo
|
||||
description: Removes the photo from the current user's favorites.
|
||||
security:
|
||||
- bearerAuth: []
|
||||
parameters:
|
||||
- name: id
|
||||
in: path
|
||||
required: true
|
||||
schema:
|
||||
type: string
|
||||
format: uuid
|
||||
responses:
|
||||
"200":
|
||||
description: Favorite removed.
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
/users/me:
|
||||
get:
|
||||
summary: Get current app user
|
||||
security:
|
||||
- bearerAuth: []
|
||||
responses:
|
||||
"200":
|
||||
description: Current app user profile.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
type: object
|
||||
properties:
|
||||
user:
|
||||
$ref: "#/components/schemas/AppUser"
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
/users/me/favorites:
|
||||
get:
|
||||
summary: List current user's favorite photos
|
||||
security:
|
||||
- bearerAuth: []
|
||||
parameters:
|
||||
- name: page
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
default: 1
|
||||
- name: pageSize
|
||||
in: query
|
||||
schema:
|
||||
type: integer
|
||||
minimum: 1
|
||||
maximum: 100
|
||||
default: 24
|
||||
responses:
|
||||
"200":
|
||||
description: Paginated favorite picked photos.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
type: array
|
||||
items:
|
||||
$ref: "#/components/schemas/FavoritePhoto"
|
||||
pagination:
|
||||
$ref: "#/components/schemas/Pagination"
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
post:
|
||||
summary: Add a picked photo to current user's favorites
|
||||
security:
|
||||
- bearerAuth: []
|
||||
requestBody:
|
||||
required: true
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
required:
|
||||
- photoId
|
||||
properties:
|
||||
photoId:
|
||||
type: string
|
||||
format: uuid
|
||||
responses:
|
||||
"200":
|
||||
description: Favorited photo.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
$ref: "#/components/schemas/FavoritePhoto"
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
/users/me/favorites/{photoId}:
|
||||
delete:
|
||||
summary: Remove a photo from current user's favorites
|
||||
security:
|
||||
- bearerAuth: []
|
||||
parameters:
|
||||
- name: photoId
|
||||
in: path
|
||||
required: true
|
||||
schema:
|
||||
type: string
|
||||
format: uuid
|
||||
responses:
|
||||
"200":
|
||||
description: Favorite removed.
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
/users/me/settings:
|
||||
get:
|
||||
summary: Get current user's preferences
|
||||
security:
|
||||
- bearerAuth: []
|
||||
responses:
|
||||
"200":
|
||||
description: User preferences and download preferences.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
$ref: "#/components/schemas/UserSettings"
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
patch:
|
||||
summary: Update current user's preferences
|
||||
security:
|
||||
- bearerAuth: []
|
||||
requestBody:
|
||||
required: true
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
preferences:
|
||||
type: object
|
||||
additionalProperties: true
|
||||
downloadPreferences:
|
||||
type: object
|
||||
additionalProperties: true
|
||||
responses:
|
||||
"200":
|
||||
description: Updated user settings.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
$ref: "#/components/schemas/UserSettings"
|
||||
"401":
|
||||
description: Missing or invalid app user JWT.
|
||||
components:
|
||||
securitySchemes:
|
||||
bearerAuth:
|
||||
type: http
|
||||
scheme: bearer
|
||||
bearerFormat: JWT
|
||||
schemas:
|
||||
AppUser:
|
||||
type: object
|
||||
properties:
|
||||
id:
|
||||
type: string
|
||||
format: uuid
|
||||
email:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
format: email
|
||||
displayName:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
avatarUrl:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
authProvider:
|
||||
type: string
|
||||
AuthResponse:
|
||||
type: object
|
||||
properties:
|
||||
ok:
|
||||
type: boolean
|
||||
data:
|
||||
type: object
|
||||
properties:
|
||||
token:
|
||||
type: string
|
||||
user:
|
||||
$ref: "#/components/schemas/AppUser"
|
||||
FavoritePhoto:
|
||||
allOf:
|
||||
- $ref: "#/components/schemas/PickedGalleryPhoto"
|
||||
- type: object
|
||||
properties:
|
||||
favoritedAt:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
format: date-time
|
||||
PhotoCollection:
|
||||
type: object
|
||||
properties:
|
||||
id:
|
||||
type: string
|
||||
format: uuid
|
||||
title:
|
||||
type: string
|
||||
slug:
|
||||
type: string
|
||||
description:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
coverPhoto:
|
||||
oneOf:
|
||||
- $ref: "#/components/schemas/PickedGalleryPhoto"
|
||||
- type: "null"
|
||||
coverUrl:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
photoCount:
|
||||
type: integer
|
||||
publishedAt:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
format: date-time
|
||||
PickedGalleryPhoto:
|
||||
type: object
|
||||
properties:
|
||||
id:
|
||||
type: string
|
||||
format: uuid
|
||||
unsplashId:
|
||||
type: string
|
||||
slug:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
description:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
altDescription:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
width:
|
||||
type:
|
||||
- integer
|
||||
- "null"
|
||||
height:
|
||||
type:
|
||||
- integer
|
||||
- "null"
|
||||
color:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
colorFamily:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
url:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
sourceUrl:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
user:
|
||||
type: object
|
||||
additionalProperties: true
|
||||
likes:
|
||||
type:
|
||||
- integer
|
||||
- "null"
|
||||
pickedAt:
|
||||
type:
|
||||
- string
|
||||
- "null"
|
||||
format: date-time
|
||||
isFavorited:
|
||||
type: boolean
|
||||
UserSettings:
|
||||
type: object
|
||||
properties:
|
||||
preferences:
|
||||
type: object
|
||||
additionalProperties: true
|
||||
downloadPreferences:
|
||||
type: object
|
||||
additionalProperties: true
|
||||
updatedAt:
|
||||
type: string
|
||||
format: date-time
|
||||
Pagination:
|
||||
type: object
|
||||
properties:
|
||||
page:
|
||||
type: integer
|
||||
pageSize:
|
||||
type: integer
|
||||
total:
|
||||
type: integer
|
||||
hasMore:
|
||||
type: boolean
|
||||
nextPage:
|
||||
type:
|
||||
- integer
|
||||
- "null"
|
||||
@@ -0,0 +1 @@
|
||||
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>
|
||||
|
After Width: | Height: | Size: 128 B |
@@ -0,0 +1 @@
|
||||
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>
|
||||
|
After Width: | Height: | Size: 385 B |
Reference in New Issue
Block a user