API метод host_info. Информация о сайте по домену.
API метод host_info() возвращает информацию о сайте по переданному домену. Вы можете задать список доменов для получения информации по каждому домену за один API вызов.
Вызов требует параметр GET:
- method_name — должен быть 'host_info'
- host — домен сайта
Дополнительный параметры POST:
- data — список доменов, разделённых запятой (,).
Пример
https://api.cleantalk.org/?method_name=host_info&host=google.com
API возвращает JSON-строку, например:
{
"data": {
"cleantalk.org": {
"whois": "Domain Name: cleantalk.org\nRegistry Domain ID: 76eba9fb99924fdab83b9c1fd4d5a7ac-LROR\n ...",
"host": "cleantalk.org has address 49.13.78.26\ncleantalk.org has IPv6 address 2a01:4f8:c012:daf9::1\n ..."
}
}
}
Разъяснение ответа:
- data — массив с проверенными записями,
- record — массив с подробностями каждой записи,
- whois — информация о сайте, полученная утилитой whois
- host — информация о сайте, полученная утилитой host
- record — массив с подробностями каждой записи,
Возможные ошибки:
- Data not found. Такая ошибка возможна, если не передан GET-параметр "host" или не передан POST-параметр "data" или в переданных параметрах указан неправильный домен.
{"error_message":"Data not found","error_no":8,"data":{"operation_status":"FAILED","operation_message":"Data not found"}}
- Received 11 records to check, maximum 10 records check per call. Такая ошибка возможна, если превышено возможное число доменов в одном запросе. Ограничение: 10 доменов в одном запросе.
{"error_message":"Received 11 records to check, maximum 10 records check per call.","error_no":8,"data":{"operation_status":"FAILED","operation_message":"Received 1001 records to check, maximum 1000 records check per call."}}
- Calls limit exceeded. Такая ошибка возможна, если превышено число вызовов метода. Ограничение: 10 запросов в минуту. Рекомендованный тайм-аут не более 180 секунд.
{"error_message":"Calls limit exceeded, method name host_info().","error_no":10}