INTEGRITY Документация

Пользовательские имена хостов


Коды успешных ответов

Конечная точка Метод Код
/v4/zones/:zone_id/custom_hostnames POST 201 Created
/v4/zones/:zone_id/custom_hostnames/:custom_hostname_id GET 200 OK
/v4/zones/:zone_id/custom_hostnames GET 200 OK
/v4/zones/:zone_id/custom_hostnames/:custom_hostname_id DELETE 200 OK
/v4/zones/:zone_id/custom_hostnames/:custom_hostname_id PATCH 202 Accepted

Коды ошибок

Код состояния HTTP Код ошибки API Сообщение об ошибке
400 1400 Не удалось декодировать тело запроса JSON. Проверьте введённые данные и повторите попытку.
400 1401 Не удалось закодировать Custom Metadata в формате JSON. Проверьте введённые данные и повторите попытку.
400 1402 Требуется ID зоны. Проверьте введённые данные и повторите попытку.
400 1403 В запросе отсутствует заголовок Authorization. Проверьте введённые данные и повторите попытку.
400 1407 Недопустимое пользовательское имя хоста. Пользовательские имена хостов должны быть короче 256 символов, не могут быть IP-адресами и не могут содержать специальные символы, такие как ``~`!@#$%^&*()=+[]\
400 1408 Пользовательские имена хостов с символами, отличными от ASCII, не поддерживаются. Проверьте введённые данные и повторите попытку.
400 1409 Пользовательские имена хостов с зарезервированным доменом верхнего уровня, например 'test', 'example', 'invalid' или 'localhost', не поддерживаются. Проверьте введённые данные и повторите попытку.
400 1410 Не удалось разобрать пользовательское имя хоста: :reason. Проверьте введённые данные и повторите попытку.
Причины:
publicsuffix: cannot derive eTLD+1 for domain :domain
publicsuffix: invalid public suffix :suffix для домена :domain
400 1411 Пользовательские имена хостов, оканчивающиеся на example.com, example.net или example.org, запрещены. Проверьте введённые данные и повторите попытку.
400 1412 Пользовательские метаданные для подстановочных пользовательских имён хостов не поддерживаются. Проверьте введённые данные и повторите попытку.
Примечание:
Это сообщение показывается только клиентам, которые отказались от поддержки wildcard для пользовательских метаданных.
400 1415 Недопустимое имя хоста пользовательского origin-сервера. Имена хостов пользовательского origin-сервера должны быть короче 256 символов, не могут быть IP-адресами и не могут содержать специальные символы, такие как ```!@#$%^&*()=+[]\
400 1416 Имена хостов пользовательского исходного сервера с символами, отличными от ASCII, не поддерживаются. Проверьте введённые данные и повторите попытку.
400 1417 Имена хостов пользовательского исходного сервера с зарезервированным доменом верхнего уровня, например 'test', 'example', 'invalid' или 'localhost', не поддерживаются. Проверьте введённые данные и повторите попытку.
400 1418 Не удалось разобрать имя хоста пользовательского исходного сервера: :reason. Проверьте введённые данные и повторите попытку.
Причины:
publicsuffix: cannot derive eTLD+1 for domain :domain
publicsuffix: invalid public suffix:suffixдля домена:domain
400 1419 Имена хостов пользовательского исходного сервера, оканчивающиеся на example.com, example.net или example.org, запрещены. Проверьте введённые данные и повторите попытку.
400 1420 Подстановочные имена хостов пользовательского исходного сервера не поддерживаются. Проверьте введённые данные и повторите попытку.
400 1421 Указанное вами имя хоста пользовательского исходного сервера не существует на Cloudflare в виде DNS-записи (A, AAAA или CNAME) в вашей зоне::zone\_tag. Проверьте введённые данные и повторите попытку.
400 1422 Недопустимый http2настройку. Принимается только значение 'on' или 'off'. Проверьте введённые данные и повторите попытку.
400 1423 Недействительноtls\_1\_2\_onlyнастройку. Принимается только значение 'on' или 'off'. Проверьте введённые данные и повторите попытку.
400 1424 Недействительноtls\_1\_3настройку. Принимается только значение 'on' или 'off'. Проверьте введённые данные и повторите попытку.
400 1425 Недействительноmin\_tls\_versionнастройку. Принимается только значение '1.0','1.1','1.2' или '1.3'. Проверьте введённые данные и повторите попытку.
400 1426 Не удалось обработать загруженный вами сертификат. Проверьте введённые данные и повторите попытку.
400 1427 Загруженный вами сертификат пуст. Проверьте введённые данные и повторите попытку.
400 1428 Не удалось обработать загруженный закрытый ключ. Проверьте введённые данные и повторите попытку.
400 1429 Загруженный закрытый ключ не соответствует сертификату. Проверьте введённые данные и повторите попытку.
400 1430 ID пользовательского CSR недействителен. Проверьте введённые данные и повторите попытку.
404 1431 Пользовательский CSR не найден.
400 1432 Метод проверки не поддерживается. Поддерживается толькоhttp, email, или txt принимаются. Проверьте введённые данные и повторите попытку.
400 1433 Тип проверки не поддерживается. Принимается только значение 'dv'. Проверьте введённые данные и повторите попытку.
400 1434 Атрибут SSL недействителен. См. документацию API, проверьте введённые данные и повторите попытку.
400 1435 ID пользовательского имени хоста недействителен. Проверьте введённые данные и повторите попытку.
404 1436 Пользовательское имя хоста не найдено.
400 1437 Недопустимый параметр запроса hostname.contain. Параметр запроса hostname.contain должен быть короче 256 символов, не может быть IP-адресом и не может содержать специальные символы, такие как ``~`!@#$%^&*()=+[]\
400 1438 Нельзя указывать другие параметры фильтра вместе с id. Необходимо указать только одно значение. Проверьте введённые данные и повторите попытку.
409 1439 Изменение пользовательского имени хоста не поддерживается. Проверьте введённые данные и повторите попытку.
400 1440 Необходимо указать тип проверки и метод проверки. Проверьте введённые данные и повторите попытку.
400 1441 Не удалось связать загруженный вами сертификат с публичным trust store. Проверьте введённые данные и повторите попытку.
400 1442 Недопустимый ciphers настройку. Список поддерживаемых наборов шифров приведён в документации. Проверьте введённые данные и повторите попытку.
400 1443 Выбор набора шифров не поддерживается при минимальной версии TLS 1.3. Проверьте введённые данные и повторите попытку.
400 1444 Цепочка сертификатов, которую вы загрузили, содержит несколько конечных сертификатов. Проверьте введённые данные и повторите попытку.
400 1445 Цепочка сертификатов, которую вы загрузили, не содержит ни одного конечного сертификата. Проверьте введённые данные и повторите попытку.
400 1446 Загруженный вами сертификат не включает пользовательское имя хоста: :custom_hostname. Проверьте введённые данные и повторите попытку.
400 1447 Загруженный вами сертификат использует неподдерживаемый алгоритм подписи. Поддерживаются только алгоритмы подписи SHA-256/ECDSA, SHA-256/RSA и SHA-1/RSA. Проверьте введённые данные и повторите попытку.
400 1448 Пользовательские имена хостов с подстановочными знаками не поддерживаются для сертификатов, управляемых Cloudflare. Проверьте введённые данные и повторите попытку.
400 1449 Входные данные запроса bundle_method должно быть одним из значений: ubiquitous, optimal, force.
401 1000 Не удалось извлечь bearer token
401 1001 Не удалось разобрать токен JWT
401 1002 Неверный заголовок JWT
401 1003 Не удалось проверить токен JWT
401 1004 Не удалось получить claims из токена JWT
401 1005 Токен JWT не содержит обязательных claims
403 1404 Для этой зоны не выделена квота. Если вы уже являетесь платным клиентом Cloudflare for SaaS, обратитесь к своему Customer Success Manager, чтобы запросить дополнительные ресурсы. Если вы ещё не подключены, заполните эту контактную форму ↗ и наш отдел продаж выйдет с вами на связь.
403 1405 Квота превышена. Если вы уже являетесь платным клиентом Cloudflare for SaaS, обратитесь к своему Customer Success Manager, чтобы запросить дополнительные ресурсы. Если вы ещё не подключены, заполните эту контактную форму ↗ и наш отдел продаж выйдет с вами на связь.
403 1413 Нет пользовательские метаданные доступ был выделен для этой зоны. Если вы уже являетесь платным клиентом, обратитесь к своему Customer Success Manager за дополнительным выделением ресурсов. Если вы ещё не подключены, заполните эту контактную форму ↗ и наш отдел продаж выйдет с вами на связь.
403 1414 Для этой зоны не предоставлен доступ к настройке пользовательского origin-сервера. Если вы уже являетесь платным клиентом Cloudflare for SaaS, обратитесь к своему Customer Success Manager, чтобы запросить дополнительные ресурсы. Если вы ещё не подключены, заполните эту контактную форму ↗ и наш отдел продаж выйдет с вами на связь.
409 1406 Обнаружено дублирующееся пользовательское имя хоста.
500 1500 Internal Server Error