{"info":{"_postman_id":"f2b3715d-a035-42f9-a9be-e7e6507bcb57","name":"RANDUS.ORG API 2.0 (RU)","description":"

Добро пожаловать в документацию RANDUS.ORG API на русском языке!

Чтобы начать пользоваться нашим API, вам необходимо сначала зарегистрироваться на нашем сайте и получить токен авторизации, который указывается в заголовке каждого запроса в следующем формате: Authorization: Bearer <ваш токен>. Помните, что мы предоставляем доступ к API согласно нашим тарифным планам. Поэтому просим вас ознакомиться со всеми тарифами и их возможностями. После регистрации вы автоматически получаете доступ к бесплатному API. Ниже описаны всевозможные запросы к нашему API.

Пример запроса к API на Python

import requests\nheaders = {\"Authorization\": \"Bearer Token\"} # вместо Token указывается ваш действительный токен, полученный на сайте при регистрации\nrequests.get(\"https://randus.org/api/person\", headers=headers).json()\n

Поддержка

Если у вас имеются какие-либо технические вопросы, то вы можете задать их нам при помощи тикет-системы в своем Личном кабинете на сайте.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"8649158","collectionId":"f2b3715d-a035-42f9-a9be-e7e6507bcb57","publishedId":"SztEYRaL","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-05-30T20:42:45.000Z"},"item":[{"name":"Получить информацию об аккаунте","id":"7c7c35c4-1322-4c7c-8945-488b4741a587","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/user","description":"

Данный метод позволяет вам получить информацию о своем аккаунте, включая данные о тарифном плане и текущих лимитах.

Обратите внимание на поля expired_at, left_requests и bulk_limit. expired_at — указывает на дату окончания предоставления услуг по данному тарифному плану, left_requests — показывает число оставшихся запросов к API, bulk_limit — это максимальное значение, которое может принимать параметр count (о нем речь пойдет чуть позже).

Это основной метод нашего API. Ответом на запрос выступает json, содержащий данные о сгенерированной случайной личности. Пожалуйста, имейте в виду, что ответ содержит те поля, которые предусмотрены вашим тарифным планом. Вы можете ознакомиться со списком доступных полей здесь.

Этот параметр позволяет вам выбрать язык сгенерированных данных. Все тарифы имеют разные наборы доступных языков. Вы можете ознакомиться со списком языков для вашего тарифного плана здесь.

Доступные коды языков:

ru — Русский
en — Английский
uk — Украинский

Вы можете комбинировать этот параметр с другими через символ &.

Вы можете выбрать конкретные поля данных для случайной личности. Со списком доступных полей в рамках тарифа вы можете ознакомиться, например, сделав обычный запрос к API без использования каких-либо параметров. Имеется возможность запрашивать сразу несколько определенных полей, для этого используйте запись через запятую. Например, запрос с параметром fields=name,gender вернет только имя и пол случайной личности.

Вы можете комбинировать этот параметр с другими через символ &.

Этот параметр позволяет генерировать сразу несколько случайных личностей в рамках одного запроса. Максимальное число одновременно сгенерированных персонажей определяется переменной bulk_limit, значение которой вы можете узнать с помощью запроса, описанного в разделе «Получить информацию об аккаунте». Просим учесть, что bulk_limit — это максимальное значение параметра count, его допустимое значение в действительности определяется длиной ответа от API.

Вы можете комбинировать этот параметр с другими через символ &.

Обратите внимание, что этот параметр не работает с fileds=neuralPhoto.

Вы можете выбрать желаемый пол случайной личности с помощью данного параметра.

Доступные коды полов:

0 — мужской
1 — женский

Вы можете комбинировать этот параметр с другими через символ &.

Обратите внимание, что этот параметр не работает с fileds=neuralPhoto.

Вы можете генерировать реальные фотографии нереальных людей с помощью нейронных сетей, если эта опция включена в ваш тарифный план. Проверить возможность использования нейросетей можно здесь.

Данный метод возвращает одну сгенерированную нейросетью фотографию человека в формате base64. Ниже приведен пример кода на Python, который декодирует бинарные данные, полученные с помощью нашего API:

import requests\nfrom PIL import Image\nfrom io import BytesIO\nfrom base64 import b64decode\nheaders = {\"Authorization\": \"Bearer Token\"} # вместо Token указывается ваш действительный токен, полученный на сайте при регистрации\ncontent = requests.get(\"https://randus.org/api/person?fields=neuralPhoto\", headers=headers).json()['result'][0]\nwith BytesIO(b64decode(content['neuralPhoto'])) as f:\n    with Image.open(f) as img:\n        img.save('test.jpg')\n\n

Вы можете использовать этот параметр с другими полями, доступными в вашем тарифе.

Обратите внимание, что этот параметр не работает с count=count_value и gender=gender_code.

Данная функция находится в β-тесте, поэтому возможна ее нестабильная работа.

Здесь приведен пример комбинированного запроса. Вы можете использовать совершенно различные комбинации совместимых параметров.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"f2b3715d-a035-42f9-a9be-e7e6507bcb57","id":"f2b3715d-a035-42f9-a9be-e7e6507bcb57","name":"RANDUS.ORG API 2.0 (RU)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[{"key":"lang","value":"lang_code"},{"key":"gender","value":"gender_code"},{"key":"fields","value":"fields_list"},{"key":"count","value":"count_value"}],"variable":[]}},"response":[],"_postman_id":"139d9cf3-5ed4-4ada-9a7f-77523275f8e7"}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]}},"event":[{"listen":"prerequest","script":{"id":"d6812552-0718-4b38-b4ba-6204a1000989","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"6e7fda06-6ae4-4793-b727-3916b7447282","type":"text/javascript","exec":[""]}}],"variable":[{"key":"token","value":"Your Token"},{"key":"site","value":"https://randus.org"},{"key":"lang_code","value":"lang_code"},{"key":"fields","value":"fields_list"},{"key":"count","value":"count_value"},{"key":"gender","value":"gender_code"}]}