List branches
branches:readPaginated; ordered by name. Scope branches:read.
المعاملات
| الاسم | الموضع | النوع | الوصف |
|---|---|---|---|
page | query | integer (int32)الافتراضي: 1 | Page number, starting at 1. |
pageSize | query | integer (int32)الافتراضي: 25 | Items per page, 1 to 100 (larger values are clamped to 100). |
search | query | string | Optional text matched against name, code and city. |
activeOnly | query | boolean | When true, only active branches. |
مثال طلب
curl -G "https://api.goldrock.live/api/public/v1/branches" \
-H "X-API-Key: lmc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "X-API-Secret: YOUR_API_SECRET" \
--data-urlencode 'activeOnly=true'const params = new URLSearchParams({
"activeOnly": "true"
});
const response = await fetch(`https://api.goldrock.live/api/public/v1/branches?${params}`, {
method: "GET",
headers: {
"X-API-Key": "lmc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"X-API-Secret": "YOUR_API_SECRET"
},
});
const data = await response.json();
console.log(response.status, data);<?php
$url = 'https://api.goldrock.live/api/public/v1/branches?' . http_build_query([
'activeOnly' => 'true',
]);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-API-Key: lmc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
'X-API-Secret: YOUR_API_SECRET',
],
]);
$result = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($status, json_decode($result, true));import requests
response = requests.request(
"GET",
"https://api.goldrock.live/api/public/v1/branches",
headers={
"X-API-Key": "lmc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"X-API-Secret": "YOUR_API_SECRET",
},
params={
"activeOnly": "true",
},
timeout=30,
)
print(response.status_code, response.json())تستخدم الأمثلة مفتاح API؛ استبدل القيم النائبة. لاستخدام رمز Bearer أرسل Authorization: Bearer <accessToken>.
الاستجابات
200A page of branches.
الاستجابات · الحقل
| الحقل | النوع | الوصف |
|---|---|---|
items | array<PublicBranchDto>يقبل null | Items of the requested page. |
iditems[].id | string (uuid) | Branch id. |
nameitems[].name | stringيقبل null | Branch name. |
codeitems[].code | stringيقبل null | Branch code. |
cityitems[].city | stringيقبل null | City name as entered on the branch. |
phoneitems[].phone | stringيقبل null | Branch phone, when set. |
latitudeitems[].latitude | number (double)يقبل null | Latitude, when set. |
longitudeitems[].longitude | number (double)يقبل null | Longitude, when set. |
isActiveitems[].isActive | boolean | Whether the branch is active. |
page | integer (int32) | Current page number, starting at 1. |
pageSize | integer (int32) | Requested page size (1 to 100, default 25). |
totalCount | integer (int32) | Total number of items across all pages. |
totalPages | integer (int32) | Total number of pages. |
{
"page": 1,
"pageSize": 1,
"totalCount": 1,
"totalPages": 1
}| الحالة | الوصف |
|---|---|
400 | The request is invalid (code |
401 | Authentication is missing or invalid (code |
403 | Missing scope or public API disabled. |
429 | Too many requests (code |
تشترك أخطاء الواجهة في جسم واحد موصوف في مرجع الأخطاء. مرجع الأخطاء