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/12475/img_698236ce009bc_83838796fc3dd86a56b7.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-9fa17510-cd1b-4a8b-b911-926143c3fa36",
"hash_id": "lch-4HTT"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236ce4ae00_11d6d0c95f87dce81ac9.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-7fed9795-effa-4660-a3e8-8b6cb840b855",
"hash_id": "lch-4HTU"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236ce970b3_830d810c7c403d8c5fb6.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-f2df56f6-f502-46f8-9f5a-68264d3860ca",
"hash_id": "lch-4HTW"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236cee0941_b761a54febe6079be0a7.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-250827a6-d0aa-4a8b-91ba-5479ab37d78d",
"hash_id": "lch-4HTX"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236cf321cc_c1a53cdfe244afee0873.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-71a775a8-3f5d-493a-9af9-d73a96490b56",
"hash_id": "lch-4HTY"
}
],
"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/12475/img_698236ce009bc_83838796fc3dd86a56b7.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-9fa17510-cd1b-4a8b-b911-926143c3fa36",
"hash_id": "lch-4HTT"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236ce4ae00_11d6d0c95f87dce81ac9.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-7fed9795-effa-4660-a3e8-8b6cb840b855",
"hash_id": "lch-4HTU"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236ce970b3_830d810c7c403d8c5fb6.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-f2df56f6-f502-46f8-9f5a-68264d3860ca",
"hash_id": "lch-4HTW"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236cee0941_b761a54febe6079be0a7.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-250827a6-d0aa-4a8b-91ba-5479ab37d78d",
"hash_id": "lch-4HTX"
},
{
"options": {
"public_url": "http://localhost:8080/storage/12475/img_698236cf321cc_c1a53cdfe244afee0873.png",
"size_in_bytes": null,
"dimension_height": 251,
"dimension_width": 1151,
"hash_md5": "8d6b96e4c1a5cd5450f6169fedd6e9c1"
},
"mime_type": "image/png",
"lcuid": "LCUID-LM-71a775a8-3f5d-493a-9af9-d73a96490b56",
"hash_id": "lch-4HTY"
}
],
"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
}
}