Account
Methods of the “Account” group. On the right — a request and response example for each.
Who am I
GET
/v1/me/0 unitsall plans, including “API.Max Test”
Who you are for the API: the key’s user and organization, paid products, API plan, request limits per period (30 days from payment) and per second, used and remaining requests, remaining request packs. The organization balance is shown only to the owner’s key, read-only. The method is free (0 units): handy for checking the key and what’s left.
Response fields
| Field | Type | Description |
|---|---|---|
id | number | user ID |
email | string | Email of the key owner |
organization | string | Name of the organization the key belongs to |
organization_id | number | Organization number in datool.ru |
products | list | Paid products: max, tg, vk, dzen, com, collector, api_max (API.Max), all (the all-in-one subscription) |
api_key | string | Masked key used for this request |
api_tariff | string | The organization’s API plan, e.g. “API.Max Start” |
requests_period | number or null | Requests per period (30 days from payment) on the plan; null — by contract |
requests_per_second | number or null | Requests per second on the plan; null — by contract |
period_start | date and time | Start of the current limit period (ISO 8601, Moscow time): every 30 days from plan payment |
period_end | date and time | End of the current period (ISO 8601, Moscow time) — the limit renews then |
used_period | number | Units used this period |
remaining_period | number or null | Units left this period; null — unlimited |
packs_left | number | Left in request packs — used after the plan limit |
limits_enforced | yes / no | Whether limits restrict requests (enabled together with API plan sales) |
balance | string or null | Organization balance in rubles — only for the owner’s key, otherwise null |
Errors
| Code | code | When |
|---|---|---|
| 401 | not_authenticated / authentication_failed | No key, the key is wrong or revoked, the member is suspended or the key’s organization is archived. |
| 429 | rate_limited / throttled | Too often — more requests per second than your plan allows; how long to wait is in the Retry-After header. |
The error format, limit headers and what to do about each error are in the article “Errors”.