GET /api/v3/images/my¶
Summary¶
GET /images/my
Description¶
Get a list of images owned by the authenticated user
Tags: creatives
Parameters¶
Header Parameters¶
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
Authorization |
string |
✓ Yes | Bearer {AuthToken} |
|
Content-Type |
string |
✓ Yes | application/json |
|
Accept |
string |
✓ Yes | application/json |
|
AppIdV3 |
string |
✓ Yes | LCUID-LAP-********-****-****-****-************ |
Request Body¶
Content Type: application/json¶
Schema¶
Type: object
Properties:
query(string)page(integer): Must be at least 1.per_page(integer): Must be at least 1. Must not be greater than 100.
Responses¶
Response: 200¶
Content Type: application/json¶
Schema¶
Type: object
Properties:
success(boolean)images(object) Type:object
Properties:
current_page(integer)-
data(array)- Array items:
objectType:object
Properties:
-
options(object) Type:objectProperties:
public_url(string)size_in_bytes(string)dimension_height(integer)dimension_width(integer)hash_md5(string)
-
mime_type(string) lcuid(string)hash_id(string)
- Array items:
-
first_page_url(string) from(integer)last_page(integer)last_page_url(string)-
links(array)- Array items:
objectType:object
Properties:
url(string)label(string)active(boolean)
- Array items:
-
next_page_url(string) path(string)per_page(integer)prev_page_url(string)to(integer)total(integer)
Example Response¶
{
"success": true,
"images": {
"current_page": 1,
"data": [
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c995aea3_a7d8242f20d7ba0cabb2.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-e3e7f3b5-b596-4c2f-abc1-e454fe839a5e",
"hash_id": "lch-4HaE"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c99a8b46_6dc05592fa47a4e66816.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-730ee2ce-145f-4359-b732-27bd5db241bf",
"hash_id": "lch-4HaF"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c99f1f58_3fcff73e05da152ab1f3.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-66920267-df52-47bd-83cb-42cfa293487b",
"hash_id": "lch-4HaG"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c9a4bd85_51eb54d21afc4bc91872.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-c722e8b4-b966-4052-a444-25c7b85afa95",
"hash_id": "lch-4HaH"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c9a9b02a_90cbc9408bc0258b7444.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-5782ac61-1afd-43c9-b31c-0ffd9131fd01",
"hash_id": "lch-4HaI"
}
],
"first_page_url": "http://localhost:8080/api/v3/images/my?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost:8080/api/v3/images/my?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost:8080/api/v3/images/my?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost:8080/api/v3/images/my",
"per_page": 25,
"prev_page_url": null,
"to": 5,
"total": 5
}
}
Example Implementations¶
Bash (cURL)¶
curl --request GET \
--get "https://api.lucit.app/api/v3/images/my" \
--header "Authorization: Bearer {AuthToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "AppIdV3: LCUID-LAP-********-****-****-****-************" \
--data "{
\"query\": \"aliquid\",
\"page\": 72,
\"per_page\": 3
}"
JavaScript (Fetch API)¶
const url = new URL(
"https://api.lucit.app/api/v3/images/my"
);
const headers = {
"Authorization": "Bearer {AuthToken}",
"Content-Type": "application/json",
"Accept": "application/json",
"AppIdV3": "LCUID-LAP-********-****-****-****-************",
};
let body = {
"query": "aliquid",
"page": 72,
"per_page": 3
};
fetch(url, {
method: "GET",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
PHP (Guzzle)¶
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://api.lucit.app/api/v3/images/my',
[
'headers' => [
'Authorization' => 'Bearer {AuthToken}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
'AppIdV3' => 'LCUID-LAP-********-****-****-****-************',
],
'json' => [
'query' => 'aliquid',
'page' => 72,
'per_page' => 3,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Python (Requests)¶
import requests
import json
url = 'https://api.lucit.app/api/v3/images/my'
payload = {
"query": "aliquid",
"page": 72,
"per_page": 3
}
headers = {
'Authorization': 'Bearer {AuthToken}',
'Content-Type': 'application/json',
'Accept': 'application/json',
'AppIdV3': 'LCUID-LAP-********-****-****-****-************'
}
response = requests.request('GET', url, headers=headers, json=payload)
response.json()
Example Responses¶
200 Response¶
{
"success": true,
"images": {
"current_page": 1,
"data": [
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c995aea3_a7d8242f20d7ba0cabb2.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-e3e7f3b5-b596-4c2f-abc1-e454fe839a5e",
"hash_id": "lch-4HaE"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c99a8b46_6dc05592fa47a4e66816.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-730ee2ce-145f-4359-b732-27bd5db241bf",
"hash_id": "lch-4HaF"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c99f1f58_3fcff73e05da152ab1f3.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-66920267-df52-47bd-83cb-42cfa293487b",
"hash_id": "lch-4HaG"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c9a4bd85_51eb54d21afc4bc91872.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-c722e8b4-b966-4052-a444-25c7b85afa95",
"hash_id": "lch-4HaH"
},
{
"options": {
"public_url": "http://localhost:8080/storage/61128/img_6ac80c9a9b02a_90cbc9408bc0258b7444.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-5782ac61-1afd-43c9-b31c-0ffd9131fd01",
"hash_id": "lch-4HaI"
}
],
"first_page_url": "http://localhost:8080/api/v3/images/my?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost:8080/api/v3/images/my?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost:8080/api/v3/images/my?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost:8080/api/v3/images/my",
"per_page": 25,
"prev_page_url": null,
"to": 5,
"total": 5
}
}