From 1f5c0e3ec746993ab25a8a9d9a658b0e43b2f9ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Desprez=20Aur=C3=A9lien?= <45626870+aurelien45100@users.noreply.github.com> Date: Wed, 22 Jun 2022 18:24:01 +0200 Subject: [PATCH] Update README.md Added the three functions actually used in the v7 of porphyry. Co-author: @callistas --- README.md | 50 ++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 36 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 004446a..b7af1c6 100644 --- a/README.md +++ b/README.md @@ -9,34 +9,56 @@ Home page: The name of "Steatite" once was a French acronym for "*Serveur de traitement, d'émission et d'archivage de textes, images et épures*". Steatite is now an image processing service. -### Get the attributes related to an uploaded picture +### Get an optimized picture -API: */item/{corpus}/{hash}* +API: `/optimized/{hash}` -> Example: https://rzi0pem2eh.execute-api.eu-west-3.amazonaws.com/PE22-230522/item/Misc/edb559800ae39b4c9c09c9e975b4736947049543 +Example: https://vogwuoualf.execute-api.eu-west-3.amazonaws.com/Steatite/optimized/b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8 + +![b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8](https://user-images.githubusercontent.com/45626870/175082351-8d980d2f-7be9-4306-8bd4-b67a692f757a.jpeg) + + +### Get a JPEG thumbnail (efficiently) + +API: `/thumbnail/{hash}` + +Example: https://vogwuoualf.execute-api.eu-west-3.amazonaws.com/Steatite/optimized/b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8![b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8] + +![b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8 (1)](https://user-images.githubusercontent.com/45626870/175082581-ecdd6aeb-319d-4927-a365-bc73d5f64a94.jpeg) + +### Get attributes related to a picture in JSON + +URI: `/item/{corpus}/{hash}` + +In addition to the name of the item, and its related URIs, +you will get the shooting date if it is present in the EXIF metadata of the picture file. + +For example, if you request the following URI: +https://vogwuoualf.execute-api.eu-west-3.amazonaws.com/Steatite/item/Test/b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8 The response will be: -``` +```yaml { "rows": [ { "key": [ - "Misc", - "edb559800ae39b4c9c09c9e975b4736947049543" + "Test", + "b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8" ], "value": { - "hash": "edb559800ae39b4c9c09c9e975b4736947049543", - "created": "2022-05-30", - "thumbnail": "https://pe22-test.s3.eu-west-3.amazonaws.com/Thumbnail/flute_logo.png", - "optimized": "https://pe22-test.s3.eu-west-3.amazonaws.com/Optimized/flute_logo.jpeg", - "name": "flute_logo.png", - "corpus": "Misc", - "resource": "https://pe22-test.s3.eu-west-3.amazonaws.com/Misc/flute_logo.png" + "created": "2020-02-05", + "baseUrlAWS": "https://steatitebucket.s3.eu-west-3.amazonaws.com/", + "name": "2000_18-25_0021_LET_R_A.jpg", + "corpus": "Test", + "response": "https://steatitebucket.s3.eu-west-3.amazonaws.com/Test/2000_18-25_0021_LET_R_A.jpg", + "optimized": "https://vogwuoualf.execute-api.eu-west-3.amazonaws.com/Steatite/optimized/b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8", + "thumbnail": "https://vogwuoualf.execute-api.eu-west-3.amazonaws.com/Steatite/thumbnail/b852cfdb04a89b0e7483a6d6d6b3315675cb4aa8" } } ] } ``` - This part of the API is compliant with the [Hypertopic protocol](https://github.com/Hypertopic/Protocol/#item-1). + +