{"info":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","description":"

Ласкаво просимо в документацію RANDUS.ORG API українською мовою!

\n

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

\n

Приклад запиту до API на Python

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

Підтримка

\n

Якщо у вас є які-небудь технічні питання, то ви можете задати їх нам за допомогою тікет-системи в своєму Особистому кабінеті на сайті.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"8649158","collectionId":"0503a159-9419-494b-b746-3c3b647d6bed","publishedId":"SztEYRt4","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-05-30T20:47:29.000Z"},"item":[{"name":"Отримати інформацію про обліковий запис","id":"a2e17dbf-acbd-4333-8662-434670f05d1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/user","description":"

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

\n

Зверніть увагу на поля expired_at, left_requests і bulk_limit. expired_at - вказує на дату закінчення надання послуг за даним тарифним планом, left_requests — показує число запитів, що залишилися до API, bulk_limit — це максимальне значення, яке може приймати параметр count (про нього мова піде трохи пізніше).

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","user"],"host":["https://randus.org"],"query":[],"variable":[]}},"response":[],"_postman_id":"a2e17dbf-acbd-4333-8662-434670f05d1e"},{"name":"Отримати дані про випадкову особу","id":"54dbf670-b2d2-441d-9b1e-2d1d0b45436e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person","description":"

Це основний метод нашого API. Відповіддю на запит виступає json, що містить дані про згенеровану випадкову особу. Будь ласка, майте на увазі, що відповідь містить ті поля, які передбачені вашим тарифним планом. Ви можете ознайомитися зі списком доступних полів тут.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[],"variable":[]}},"response":[],"_postman_id":"54dbf670-b2d2-441d-9b1e-2d1d0b45436e"},{"name":"Вибрати мову API","id":"f752a6f2-d466-4bc2-a478-ec76be3a862c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person?lang=lang_code","description":"

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

\n
Доступні коди мов:
\n\n

Ви можете комбінувати цей параметр з іншими через символ &.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[{"key":"lang","value":"lang_code"}],"variable":[]}},"response":[],"_postman_id":"f752a6f2-d466-4bc2-a478-ec76be3a862c"},{"name":"Вибрати певні поля","id":"9faaa5bf-1aa2-4ba3-ae32-e798bf3a30d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person?fields=fields_list","description":"

Ви можете вибрати конкретні поля даних для випадкової особистості. Зі списком доступних полів в рамках тарифу ви можете ознайомитися, наприклад, зробивши звичайний запит до API без використання будь-яких параметрів. Є можливість запитувати відразу кілька певних полів, для цього використовуйте запис через кому. Наприклад, запит з параметром fields=name, gender поверне тільки ім'я і стать випадкової особистості.

\n

Ви можете комбінувати цей параметр з іншими через символ &.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[{"key":"fields","value":"fields_list"}],"variable":[]}},"response":[],"_postman_id":"9faaa5bf-1aa2-4ba3-ae32-e798bf3a30d2"},{"name":"Генерація декількох особистостей","id":"bd38eff4-4274-4559-a8c6-0d99cb66ba8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person?count=count_value","description":"

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

\n

Ви можете комбінувати цей параметр з іншими через символ &.

\n

Зверніть увагу, що цей параметр не працює з fileds=neuralPhoto.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[{"key":"count","value":"count_value"}],"variable":[]}},"response":[],"_postman_id":"bd38eff4-4274-4559-a8c6-0d99cb66ba8b"},{"name":"Вибрати стать випадкової особистості","id":"1945dc27-0cdd-4a9a-8ebd-b41339fda993","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person?gender=gender_code","description":"

Ви можете вибрати бажаний стать випадкової особистості за допомогою даного параметра.

\n
Доступні коди підлог:
\n\n

Ви можете комбінувати цей параметр з іншими через символ &.

\n

Зверніть увагу, що цей параметр не працює з fileds=neuralPhoto.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[{"key":"gender","value":"gender_code"}],"variable":[]}},"response":[],"_postman_id":"1945dc27-0cdd-4a9a-8ebd-b41339fda993"},{"name":"Фото з використанням нейронних мереж (β-тест)","id":"e359799c-81ff-4110-97aa-02f157d46be5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person?fields=neuralPhoto","description":"

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

\n

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

\n
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

Ви можете використовувати цей параметр з іншими полями, доступними у вашому тарифі.

\n

Зверніть увагу, що цей параметр не працює з count=count_value і gender=gender_code.

\n

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

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","type":"collection"}},"urlObject":{"path":["api","person"],"host":["https://randus.org"],"query":[{"key":"fields","value":"neuralPhoto"}],"variable":[]}},"response":[],"_postman_id":"e359799c-81ff-4110-97aa-02f157d46be5"},{"name":"Комбіновані запити","id":"7c0b2c8d-4458-45ff-b1e8-3d0f9dc13f89","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://randus.org/api/person?lang=lang_code&gender=gender_code&fields=fields_list&count=count_value","description":"

Тут наведено приклад комбінованого запиту. Ви можете використовувати абсолютно різні комбінації сумісних параметрів.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Your Token"}]},"isInherited":true,"source":{"_postman_id":"0503a159-9419-494b-b746-3c3b647d6bed","id":"0503a159-9419-494b-b746-3c3b647d6bed","name":"RANDUS.ORG API 2.0 (UK)","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":"7c0b2c8d-4458-45ff-b1e8-3d0f9dc13f89"}],"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"}]}