Допомога

Chakloon Platform

Для розробників: як отримати ключ API Chakloon, які API й безкоштовні квоти доступні і як додати на свій сайт вхід через Chakloon.

Що це

Chakloon Platform на platform.chakloon.com — кабінет для розробників. Один ключ API виду ck_live_… працює для всіх API Chakloon. Запити надходять на api.chakloon.com. Документація кожного методу є в кабінеті на platform.chakloon.com/docs.

Як отримати ключ API

  1. Відкрийте platform.chakloon.com і увійдіть через Chakloon Passport.
  2. Створіть ключ. Скопіюйте його одразу: його показують лише раз.
  3. Надсилайте ключ із кожним запитом у заголовку Authorization: Bearer ck_live_….

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

API й безкоштовні квоти

API Що дає Безкоштовна квота
Погода погода зараз, погодинний і щоденний прогноз, попередження й астрономія для точки чи місця 1 000 запитів на день
Пошук результати з вебу й новин з індексу Chakloon Net 28 мовами 2 000 запитів на місяць
Підказки підказки запиту під час введення 20 000 запитів на місяць
Вхід через Chakloon вхід на ваш сайт через Chakloon Passport, OpenID Connect безкоштовно

Коли безкоштовну квоту вичерпано, API до наступного періоду відповідає HTTP 402 з кодом quota_exceeded. Кожна відповідь містить заголовки, що показують вашу квоту й залишок. Є також обмеження кількості запитів на хвилину; коли його досягнуто, API відповідає HTTP 429 і повідомляє, коли повторити.

Платне використання понад безкоштовні квоти й поповнення балансу карткою ще не ввімкнено. Якщо вам уже зараз потрібно більше, ніж дає безкоштовна квота, напишіть на support@chakloon.com і опишіть свій проєкт.

Дані погоди в кожній відповіді супроводжуються зазначенням джерел, і його треба показувати.

Вхід через Chakloon

Дайте людям входити на ваш сайт чи в застосунок через Chakloon Passport, безкоштовно.

  1. У кабінеті створіть застосунок.
  2. Укажіть адреси, на які користувачі повертаються після входу, по одній у рядку. Використовуйте повні адреси https://; для розробки дозволено http://localhost.
  3. Скопіюйте ідентифікатор клієнта й секрет клієнта. Секрет показують лише раз.
  4. Підключіть сайт за допомогою будь-якої бібліотеки OpenID Connect. Адресу конфігурації вказано в документації.

Після входу ви отримуєте сталий ідентифікатор користувача, нік Chakloon, ім'я, адресу пошти й ознаку, чи вона підтверджена. За дані своїх користувачів, отримані таким чином, відповідаєте ви.

Правила й куди писати

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