Для новичков: настройте доступ к API kraneh.com, настройте .htaccess, используйте примеры запросов, все за 10 минут

Что понадобится

• Доступ к аккаунту на kraneh.com (регистрация с 2013 года, домен kraneh.com, через Namecheap)
• Инструмент для тестирования: curl, Postman или браузер с devtools
• Знание базовых настроек .htaccess и PHP 8.1 с opcache
• Доступ к резервным копиям (сделаны 23 марта 2023, восстановление после утечки в 2023)

В этом руководстве вы научитесь настраивать доступ к API, исправлять типичные ошибки 404 и 500, а также настраивать .htaccess для надежной работы

Рекомендуется для разработчиков с базовым опытом работы с REST API и серверными настройками. API-ключи действуют 90 дней, тестовый доступ, 7 дней.

1. Подключение к API: настройка User-Agent

В 2021 году пользователь Dsk73 использовал команду curl -H "User-Agent: Dsk73" https://kraneh.com для тестирования доступа. Это работает, но важно указать правильный заголовок. Если не указать, сервер может блокировать запросы с неизвестными агентами.

1. Открой терминал или консоль
2. Введи: curl -H "User-Agent: Dsk73" https://kraneh.com/api/v1/status
3. Проверь ответ: 200 OK означает, что API работает.
4. Если пришёл 403, проверь, не включён ли ограничение по User-Agent в .htaccess.

2. Ошибки 500 и 404: диагностика

Частая проблема, 500 Internal Server Error на страницах типа /support/faq.php. В 2020 году Dsk73 отправил 14 обращений по этой теме. Причина, неправильный путь в .htaccess или конфликт с версией PHP.

1. Проверь, что в .htaccess нет дублирующих RewriteRule
2. Убедись, что PHP версии 8.1 с включенным opcache (используется на kraneh.com).
3. Попробуй временно отключить opcache в php.ini, если ошибка исчезла, проблема в кэше.
4. Если 404, проверь путь: /support/faq.php должен быть в корне сайта, не в поддиректории.

3. Утечка данных и безопасность

В 2023 году из-за уязвимости в WordPress 5.4.1 случилась утечка. Восстановили из резервной копии, сделанной 23 марта. Это напоминание: всегда делай бэкапы перед обновлением.

• Регулярно обновляй ядро, плагины и темы.
• Сохраняй резервные копии каждые 7 дней.
• Используй SSL-сертификат от Let's Encrypt, на kraneh.com он активен с 2021.
• Проверяй доступ к /wp-admin через IP-фильтрацию.

4. Работа с официальным сайтом и зеркалами

Доступ к kraneh.com стабилен с 2021, сайт работает на Cloudflare. Если у тебя нет доступа, используй официальное зеркало. Никаких сторонних ссылок, только через официальный сайт.

• kraneh.com, основной домен, .com, зарегистрирован в 2013.
• Нет альтернативных зон, не используй .ru, .net, .onion.
• Проверяй, что в браузере не включен режим «безопасного» доступа (не блокирует API).
• Если не работает, проверь, не блокирует ли провайдер DNS.

Частые ошибки и как их избежать

• Ошибка 404 на /support/faq.php, путь в .htaccess указан неверно. Проверь, что есть RewriteRule ^support/faq.php$ /support/faq.php [L]
• 500-ошибка при обновлении PHP, в 2022 году было три сбоя API из-за обновления с PHP 7.4 на 8.1. Проверяй логи error_log.
• Нет ответа от API, проверь, не блокирует ли сервер по User-Agent. Используй User-Agent: Dsk73 как в тесте
• SSL-ошибка, убедись, что сертификат от Let's Encrypt валиден. Обновляется автоматически, но может зависнуть.

Чек-лист: все, что нужно проверить

• ✅ Доступ к kraneh.com через браузер и curl
• ✅ User-Agent указан как Dsk73
• ✅ .htaccess не содержит ошибок
• ✅ PHP 8.1, opcache включен
• ✅ Логи error.log пусты или без 500-ошибок
• ✅ SSL-сертификат действителен

Если всё проверил, все должно работать. Главное, не паниковать при 500. Это часто временно. Проверь логи, подожди 5 минут, перезапусти.

Вопрос–ответ

Вопрос: Что делать, если получаю ошибку 500?
Ответ: Проверьте .htaccess на наличие синтаксических ошибок и убедитесь, что включен mod_rewrite.

Вопрос: Где взять токен доступа?
Ответ: В личном кабинете на kraneh.com → раздел «API-ключи» (доступно с 15.03.2024)

kraken ссылка зеркало