Merge pull request #12407 from HankG/friendica-api-photo-endpoint-updates

[friendica.git] / doc / database / db_post-media.md

diff --git a/doc/database/db_post-media.md b/doc/database/db_post-media.md
index 58f1ed7030074154a1e65cb03874f0ef17c43578..2d73a39cfc0c985071520f28ec3319f179d7787b 100644 (file)
--- a/doc/database/db_post-media.md
+++ b/doc/database/db_post-media.md
@@ -1,27 +1,51 @@
 Table post-media
 ===========
+
 Attached media
 
-| Field | Description | Type | Null | Key | Default | Extra |
-| ----- | ----------- | ---- | ---- | --- | ------- | ----- |
-| id | sequential ID | int unsigned | YES | PRI | NULL | auto_increment |    
-| uri-id | Id of the item-uri table entry that contains the item uri | int unsigned | YES |  | NULL |  |    
-| url | Media URL | varbinary(511) | YES |  | NULL |  |    
-| type | Media type | tinyint unsigned | YES |  | 0 |  |    
-| mimetype |  | varchar(60) | NO |  | NULL |  |    
-| height | Height of the media | smallint unsigned | NO |  | NULL |  |    
-| width | Width of the media | smallint unsigned | NO |  | NULL |  |    
-| size | Media size | int unsigned | NO |  | NULL |  |    
-| preview | Preview URL | varbinary(255) | NO |  | NULL |  |    
-| preview-height | Height of the preview picture | smallint unsigned | NO |  | NULL |  |    
-| preview-width | Width of the preview picture | smallint unsigned | NO |  | NULL |  |    
-| description |  | text | NO |  | NULL |  |    
-| name | Name of the media | varchar(255) | NO |  | NULL |  |    
-| author-url | URL of the author of the media | varbinary(255) | NO |  | NULL |  |    
-| author-name | Name of the author of the media | varchar(255) | NO |  | NULL |  |    
-| author-image | Image of the author of the media | varbinary(255) | NO |  | NULL |  |    
-| publisher-url | URL of the publisher of the media | varbinary(255) | NO |  | NULL |  |    
-| publisher-name | Name of the publisher of the media | varchar(255) | NO |  | NULL |  |    
-| publisher-image | Image of the publisher of the media | varbinary(255) | NO |  | NULL |  |    
+Fields
+------
+
+| Field           | Description                                                        | Type              | Null | Key | Default | Extra          |
+| --------------- | ------------------------------------------------------------------ | ----------------- | ---- | --- | ------- | -------------- |
+| id              | sequential ID                                                      | int unsigned      | NO   | PRI | NULL    | auto_increment |
+| uri-id          | Id of the item-uri table entry that contains the item uri          | int unsigned      | NO   |     | NULL    |                |
+| url             | Media URL                                                          | varbinary(1024)   | NO   |     | NULL    |                |
+| media-uri-id    | Id of the item-uri table entry that contains the activities uri-id | int unsigned      | YES  |     | NULL    |                |
+| type            | Media type                                                         | tinyint unsigned  | NO   |     | 0       |                |
+| mimetype        |                                                                    | varchar(60)       | YES  |     | NULL    |                |
+| height          | Height of the media                                                | smallint unsigned | YES  |     | NULL    |                |
+| width           | Width of the media                                                 | smallint unsigned | YES  |     | NULL    |                |
+| size            | Media size                                                         | bigint unsigned   | YES  |     | NULL    |                |
+| blurhash        | BlurHash representation of the image                               | varbinary(255)    | YES  |     | NULL    |                |
+| preview         | Preview URL                                                        | varbinary(512)    | YES  |     | NULL    |                |
+| preview-height  | Height of the preview picture                                      | smallint unsigned | YES  |     | NULL    |                |
+| preview-width   | Width of the preview picture                                       | smallint unsigned | YES  |     | NULL    |                |
+| description     |                                                                    | text              | YES  |     | NULL    |                |
+| name            | Name of the media                                                  | varchar(255)      | YES  |     | NULL    |                |
+| author-url      | URL of the author of the media                                     | varbinary(383)    | YES  |     | NULL    |                |
+| author-name     | Name of the author of the media                                    | varchar(255)      | YES  |     | NULL    |                |
+| author-image    | Image of the author of the media                                   | varbinary(383)    | YES  |     | NULL    |                |
+| publisher-url   | URL of the publisher of the media                                  | varbinary(383)    | YES  |     | NULL    |                |
+| publisher-name  | Name of the publisher of the media                                 | varchar(255)      | YES  |     | NULL    |                |
+| publisher-image | Image of the publisher of the media                                | varbinary(383)    | YES  |     | NULL    |                |
+
+Indexes
+------------
+
+| Name         | Fields                   |
+| ------------ | ------------------------ |
+| PRIMARY      | id                       |
+| uri-id-url   | UNIQUE, uri-id, url(512) |
+| uri-id-id    | uri-id, id               |
+| media-uri-id | media-uri-id             |
+
+Foreign Keys
+------------
+
+| Field | Target Table | Target Field |
+|-------|--------------|--------------|
+| uri-id | [item-uri](help/database/db_item-uri) | id |
+| media-uri-id | [item-uri](help/database/db_item-uri) | id |
 
 Return to [database documentation](help/database)