github-mirror/discourse
2
0
Fork 0
mirror of https://github.com/discourse/discourse.git synced 2024-12-22 19:35:59 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
cd8e03086f
discourse/spec/requests/api/schemas/json/upload_create_response.json

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

90 lines
1.5 KiB
JSON
Raw Normal View History

DEV: More API Doc improvements (#11849) - Create helper wrapper method `load_spec_schema(name)` - A minor change to tag_group_create response schema - Document the uploads endpoint
2021-01-26 22:38:46 +08:00
{
"additionalProperties": false,
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string"
},
"original_filename": {
"type": "string"
},
"filesize": {
"type": "integer"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"thumbnail_width": {
"type": "integer"
},
"thumbnail_height": {
"type": "integer"
},
"extension": {
"type": "string"
},
"short_url": {
"type": "string"
},
"short_path": {
"type": "string"
},
"retain_hours": {
"type": ["string", "null"]
},
"human_filesize": {
"type": "string"
UX: Use dominant color as image loading placeholder (#18248) We previously had a system which would generate a 10x10px preview of images and add their URLs in a data-small-upload attribute. The client would then use that as the background-image of the `<img>` element. This works reasonably well on fast connections, but on slower connections it can take a few seconds for the placeholders to appear. The act of loading the placeholders can also break or delay the loading of the 'real' images. This commit replaces the placeholder logic with a new approach. Instead of a 10x10px preview, we use imagemagick to calculate the average color of an image and store it in the database. The hex color value then added as a `data-dominant-color` attribute on the `<img>` element, and the client can use this as a `background-color` on the element while the real image is loading. That means no extra HTTP request is required, and so the placeholder color can appear instantly. Dominant color will be calculated: 1. When a new upload is created 2. During a post rebake, if the dominant color is missing from an upload, it will be calculated and stored 3. Every 15 minutes, 25 old upload records are fetched and their dominant color calculated and stored. (part of the existing PeriodicalUpdates job) Existing posts will continue to use the old 10x10px placeholder system until they are next rebaked
2022-09-20 17:28:17 +08:00
},
"dominant_color": {
"type": ["string", "null"]
DEV: serialize image upload thumbnail (#29276) Since we recently blocked accidental serialization of AR models, we are getting a 500 error in some cases with thumbnails. We can fix this by serializing the thumbnail, previously we just returned a raw OptimizedImage object. Thumbnails are now attached to the serializer in core, therefore we no longer need to use add_to_serializer within the chat plugin to use thumbnails within chat message uploads.
2024-10-18 16:55:14 +08:00
},
"thumbnail": {
"type": ["object", "null"],
"additionalProperties": false,
"properties": {
"id": {
"type": "integer"
},
"upload_id": {
"type": "integer"
},
"url": {
"type": "string"
},
"extension": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"filesize": {
"type": "integer"
}
}
DEV: More API Doc improvements (#11849) - Create helper wrapper method `load_spec_schema(name)` - A minor change to tag_group_create response schema - Document the uploads endpoint
2021-01-26 22:38:46 +08:00
}
},
"required": [
"id",
"url",
"original_filename",
"filesize",
"width",
"height",
"thumbnail_width",
"thumbnail_height",
"extension",
"short_url",
"short_path",
"retain_hours",
"human_filesize"
]
}
Reference in New Issue Copy Permalink