Тұтынушылар тізімі

GET /api/v1/customers

Ресурс жеткізушінің тұтынушыларының беттелген тізімін қайтарады; қажет болса, таңдаманы ресурс жеткізуші бойынша сүзгілеуге болады.

Сұрау параметрлері

energy_id integer

Ресурс жеткізушінің идентификаторы. Міндетті емес — таңдаманы тарылтады.

page integer

Бет нөмірі.

Жауап өрістері

Атрибут	Сипаттама
`id`	Жүйедегі тұтынушының идентификаторы (бірегей кілті)
`name`	Тұтынушының атауы
`subdivision_type_name`	Тұтынушының типі
`inn`	Тұтынушының салық төлеуші ретіндегі сәйкестендіру нөмірі (ҚҚС нөмірі)
`contact_number`	Байланыс нөмірі
`data`	Қайтарылатын деректер массиві
`total_pages`	Қайтарылатын таңдамадағы беттердің жалпы саны
`current_page`	Ағымдағы бет
`next_page`	Жүктеуге қолжетімді келесі бет; ағымдағы бет соңғысы болса — `null`

Сұрау

bash

curl -i \
  --header "access-token: *********************" \
  --header "token-type: Bearer" \
  --header "client: **********************" \
  --header "uid: api-user@example.com" \
  --header "Content-Type: application/json" \
  --request GET \
  "https://api.vadsro.eu/api/v1/customers?energy_id=1&page=1"

const res = await fetch('https://api.vadsro.eu/api/v1/customers?energy_id=1&page=1', {
  headers: {
    'access-token': '*********************',
    'token-type': 'Bearer',
    client: '**********************',
    uid: 'api-user@example.com',
    'Content-Type': 'application/json',
  },
});
const data = await res.json();

python

import requests

res = requests.get(
    "https://api.vadsro.eu/api/v1/customers",
    params={"energy_id": 1, "page": 1},
    headers={
        "access-token": "*********************",
        "token-type": "Bearer",
        "client": "**********************",
        "uid": "api-user@example.com",
        "Content-Type": "application/json",
    },
)
data = res.json()

req, _ := http.NewRequest("GET", "https://api.vadsro.eu/api/v1/customers?energy_id=1&page=1", nil)
req.Header.Set("access-token", "*********************")
req.Header.Set("token-type", "Bearer")
req.Header.Set("client", "**********************")
req.Header.Set("uid", "api-user@example.com")
req.Header.Set("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

php

$ch = curl_init("https://api.vadsro.eu/api/v1/customers?energy_id=1&page=1");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "access-token: *********************",
    "token-type: Bearer",
    "client: **********************",
    "uid: api-user@example.com",
    "Content-Type: application/json",
]);
$data = json_decode(curl_exec($ch), true);

Жауап

json

{"data":[
  {
    "id":13,
    "name":"Example National Sports Federation",
    "subdivision_type_name":"Unit owner",
    "inn":"1000000042",
    "contact_number":"+49-30-5550100"
  },
  ...,
  {
    "id":22,
    "name":"Example Rail Infrastructure SE",
    "subdivision_type_name":"Unit owner",
    "inn":"1000000043",
    "contact_number":"+49-30-5550102"
  }
  ],
  "total_pages":8,
  "current_page":1,
  "next_page":2
}

Соңғы жаңарту 2026 ж. 8 тамыз

Бұл бет пайдалы болды ма?