فایلهای چندرسانهای
فهرست فایلها
فایلهای آپلودشده حساب را صفحه به صفحه برمیگرداند.
GET
https://api.payamras.ir/v1/YOUR_API_KEY/media/list.json
پارامترها
| نام | نوع | توضیح |
|---|---|---|
page
اختیاری
|
Integer | شماره صفحه؛ پیشفرض ۱. |
size
اختیاری
|
Integer | تعداد در هر صفحه؛ پیشفرض ۵۰. |
نمونه درخواست
curl -G "https://api.payamras.ir/v1/YOUR_API_KEY/media/list.json" \
--data-urlencode "page=1" \
--data-urlencode "size=20"
<?php
$apiKey = 'YOUR_API_KEY';
$params = [
'page' => '1',
'size' => '20',
];
$ch = curl_init("https://api.payamras.ir/v1/{$apiKey}/media/list.json?" . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
if ($result['return']['status'] !== 200) {
throw new RuntimeException($result['return']['message']);
}
const apiKey = "YOUR_API_KEY";
const params = new URLSearchParams({
page: "1",
size: "20",
});
const response = await fetch(`https://api.payamras.ir/v1/${apiKey}/media/list.json?${params}`);
const result = await response.json();
if (result.return.status !== 200) {
throw new Error(result.return.message);
}
import requests
api_key = "YOUR_API_KEY"
params = {
"page": "1",
"size": "20",
}
response = requests.get(f"https://api.payamras.ir/v1/{api_key}/media/list.json", params=params)
result = response.json()
if result["return"]["status"] != 200:
raise RuntimeError(result["return"]["message"])
پاسخ
فیلدهای هر ردیف entries:
| فیلد | نوع | توضیح |
|---|---|---|
page |
Integer | صفحه فعلی. |
size |
Integer | اندازه صفحه. |
total |
Long | تعداد کل فایلها. |
list |
Array | فایلها، با همان فیلدهای media/get. |
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": {
"page": 1,
"size": 20,
"total": 1,
"list": [
{
"id": "3f2b7c1e-9a4d-4e21-8b0f-6c5d2a1e9f30",
"name": "banner.jpg",
"mime_type": "image/jpeg",
"extension": "jpg",
"size": 284512,
"duration": null,
"resolution": "1080x1080",
"status": 1,
"status_desc": "آماده"
}
]
}
}