Доступ к API — API. API Яндекс.Диска

Для успешного вызова API необходимы:

  • Корректные заголовки Accept и Content-Type: API Диска поддерживает только один MIME-тип, application/json. Любое другое значение приведет к ошибке формата данных.

  • URL, составленный согласно требованиям к нужному запросу.

  • OAuth-токен, выданный вашему приложению для доступа к Диску определенного пользователя. Для запросов, которые не требуют авторизации, это указано явно.

Правила, общие для всех ресурсов:

  • Хост для всех запросов к API — cloud-api.yandex.net. При загрузке и скачивании файла необходимо отдельно обращаться к сервису загрузки файлов и хранилищу Диска.

  • В каждом запросе необходимо указывать версию API, например, версия 1 обозначается так:

    cloud-api. yandex.net/v1/.

  • Корневой каталог Диска может быть указан как явно, так и неявно – пути disk:/foo и /foo указывают на одну и ту же папку.

Яндекс.Диск авторизует приложения с помощью OAuth-токенов. Каждый токен предоставляет определенному приложению доступ к данным определенного пользователя.

Чтобы использовать протокол OAuth при работе с Яндекс.Диском:

  1. Зарегистрируйте свое OAuth-приложение.

    1. Войдите в аккаунт на Яндексе.

    2. Откройте страницу создания приложения.

    3. Укажите название вашего сервиса и при необходимости прикрепите иконку.

    4. Выберите платформы, на которых будет работать ваше приложение, и укажите их параметры.

      Если вы разрабатываете или тестируете приложение, используйте отладочный токен. Для получения такого токена выберите Веб-сервисы и в поле Redirect URI подставьте значение по умолчанию, которое появится в подсказке Подставить URL для отладки: https://oauth. yandex.ru/verification_code.

    5. В разделе Доступ к данным выберите необходимые права доступа (помимо доступа к файлам пользователя можно пользоваться папкой приложения):

      • Запись в любом месте на Диске — cloud_api:disk.write;

      • Чтение всего Диска — cloud_api:disk.read;

      • Доступ к папке приложения на Диске — cloud_api:disk.app_folder;

      • Доступ к информации о Диске — cloud_api:disk.info.

    6. Укажите электронную почту для связи.

    7. Внизу страницы нажмите Создать приложение. На экране появятся его описание.

    8. Скопируйте идентификатор приложения из поля ClientID — он потребуется для получения OAuth-токена. В дальнейшем открыть страницу со всеми вашими приложениями вы сможете по ссылке oauth.yandex.ru.

  2. Получите OAuth-токены для доступа к данным пользователей любым подходящим способом.

    Отладочный токен необходимо получить вручную:

    1. Перейдите по ссылке

      https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор_приложения>

      Вместо <идентификатор_приложения> подставьте значение из пункта 1.8.

    2. Если токен вашему приложению выдается впервые, откроется экран авторизации. После входа Яндекс OAuth перенаправит вас на страницу с токеном. Подробнее об отладочных токенах.

Полученный токен следует передавать в заголовке Authorization при каждом вызове API Диска, указывая тип токена перед его значением. Пример такого заголовка:

Authorization: OAuth 0c4181a7c2cf4521964a72ff57a34a07

Была ли статья полезна?

Коммерческая версия API Яндекс.

Карт

API Яндекс.Карт включает в себя пять продуктов:

  • JavaScript API и Геокодер,

  • API Поиска по организациям,

  • Static API,

  • MapKit SDK.

  • Матрица расстояний и Построение маршрута между двумя точками

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

Если ваш проект предполагает нарушение хотя бы одного из условий или большое количество запросов, следует приобрести коммерческую версию API.

1. API должен использоваться только в проектах с открытым доступом

Бесплатная версия API предназначена только для сайтов или приложений, доступ к которым может получить любой пользователь интернета. Если есть регистрация, она должна быть доступной всем желающим.

Бесплатная версия API не предназначена для проектов с ограниченным доступом, например, когда он раздается по приглашениям или открыт только для сотрудников внутри компании.

2. Нельзя использовать API в коммерческих проектах

Бесплатная версия API не подходит для проектов, которые требуют платы за регистрацию или приобретения лицензии.

3. Данные, полученные средствами API, должны быть показаны на карте Яндекса

Результаты всех запросов к API должны быть отображены на карте Яндекса. Например, это данные, полученные с помощью сервиса геокодирования или маршрутизации.

4. Запрещается сохранять или изменять данные, полученные средствами API

Данные, полученные средствами API, нельзя сохранять. Например, нельзя один раз получить данные геокодера и затем сохранить их для дальнейшего использования. Обратите внимание, что разрешается кэшировать ответ геокодера и маршрутизатора на срок до 30 дней.

Данные, полученные через API, также нельзя изменять. Например, запрещено изменять ранжирование результатов поиска.

5. Запрещается скрывать и видоизменять копирайты и логотип Яндекса на карте

Копирайты и логотип Яндекса должны быть всегда видны на карте: их нельзя двигать, перекрывать другими элементами, скрывать или видоизменять. Это касается как интерактивных, так и статических карт. По этой причине запрещено размещение скриншотов карт. Для получения статического изображения карты вы можете воспользоваться Конструктором или Static API.

6. Нельзя использовать API для мониторинга и диспетчеризации

В бесплатной версии API запрещается использовать карту в следующих целях:

  • для отслеживания местоположения транспорта или мобильных сотрудников в реальном времени;

  • для автоматического ведения по маршруту, например в качестве навигатора.

7. Нельзя превышать суточный лимит запросов к API

В API установлен суточный лимит на использование сервисов поиска по карте, маршрутизации и панорам. Для бесплатной версии API лимит запросов к HTTP геокодеру составляет

1 000 запросов в сутки, а лимит использования JavaScript API — 25 000 запросов в сутки. В платной версии API лимит устанавливается тарифом.

8. Мобильное приложение должно содержать ссылку на Условия использования Яндекс.Карт

В разделе приложения «О программе» (или другом похожем разделе) должна быть ссылка на Условия использования Яндекс.Карт:

https://yandex.ru/legal/maps_termsofuse

Была ли статья полезна?

Изменить параметры почтового ящика — API.

Яндекс.Почта для домена API

Запрос должен быть отправлен по протоколу HTTPS методом POST.

 ПУБЛИКАЦИЯ /api2/admin/email/edit
Хост: pddimp.yandex.ru
  Описание  

Токен PDD.

"}}">: <токен PDD> ... Тип

Строка

Значение

Имя домена.

"}}">=<имя домена> &( Тип

Строка

Значение

Электронный адрес почтового ящика в формате «[email protected]» или «username».

Запрос должен передавать только один из параметров: логин или uid .

"}}">=<адрес электронной почты или имя пользователя почтового ящика>| Тип

Целое число

Значение

Идентификатор почтового ящика.

Получить значение ID можно в ответе на запрос Получить список почтовых ящиков.

Запрос должен передавать только один из параметров: 9", "&", "*", "(", ")", "_", "-", "+", ":", ";", ", "."

  • отличаться от имени пользователя.

  • "}}">=<новый пароль>] [& Тип

    Строка

    Значение

    Имя пользователя.

    "}}">=<имя>] [& Тип

    Строка

    Значение

    Фамилия пользователя.

    "}}">=<фамилия>] [& Тип

    Строка

    Значение

    Включен ли почтовый ящик.

    Возможные значения:

    "}}">=<статус почтового ящика>] [& Тип

    Строка

    Значение

    Дата рождения пользователя в формате ГГГГ-ММ-ДД.

    "}}">=<дата рождения>] [& Тип

    Целое число

    Значение

    Пол пользователя.

    Возможные значения:

    • 0 — Не указано.

    • 1 — Муж.

    • 2 — Жен.

    "}}">=<пол>] [& Тип

    Строка

    Значение

    Секретный вопрос.

    "}}">=<секретный вопрос>] [& Тип

    Строка

    Значение

    Ответ на секретный вопрос.

    "}}">=<ответ на секретный вопрос>]

    Заголовки:

    Имя Описание
    PddToken

    Токен PDD.

    Параметры:

    Параметр Тип Значение
    Обязательное
    домен Строка

    Имя домен .

    логин String

    Электронный адрес почтового ящика в формате «[email protected]» или «username».

    Запрос должен передавать только один из параметров: логин или uid .

    uid Целое число

    Идентификатор почтового ящика.

    Получить значение ID можно в ответе на запрос Получить список почтовых ящиков.

    Запрос должен передавать только один из параметров: 9″, «&», «*», «(«, «)», «_», «-«, «+», «:», «;», «, «.»

  • отличаться от имени пользователя.

  • inname Строка

    Имя пользователя.

    fname Строка

    Фамилия пользователя.

    включено Строка

    Указывает, включен ли почтовый ящик.

    Возможные значения:

    birth_date Строка

    Дата рождения пользователя в формате ГГГГ-ММ-ДД.

    пол Целое число

    Пол пользователя.

    Возможные значения:

    • 0 — Не указано.

    • 1 — Муж.

    • 2 — Жен.

    hintq Строка

    Секретный вопрос.

    хинта Строка

    Ответ на секретный вопрос.

     POST /api2/registrar/email/edit
    Хост: pddimp.yandex.ru
      Описание  

    Токен PDD.

    "}}">: <токен PDD> Описание

    Маркер доступа OAuth.

    "}}">: OAuth <токен OAuth> ... Тип

    Строка

    Значение

    Имя домена.

    "}}">=<имя домена> &( Type

    String

    Value

    Электронный адрес почтового ящика в формате «[email protected]» или «username».

    Запрос должен передавать только один из параметров: логин или uid .

    "}}">=<адрес электронной почты или имя пользователя для почтового ящика>| Тип

    Целое число

    Значение

    Идентификатор почтового ящика

    90 002 Вы можете получить значение ID в ответе на Получить список почтовых ящиков запрос 9", "&", "*", "(", ")", "_", "-", "+", ":", ";", ", ". "

  • отличаться от имени пользователя.

  • "}}">=<новый пароль>] [& Тип

    Строка

    Значение

    Имя пользователя.

    "}}">=<имя>] [& Тип

    Строка

    Значение

    Фамилия пользователя.

    "}}">=<фамилия>] [& Тип

    Строка

    Значение

    Включен ли почтовый ящик.

    Возможные значения:

    "}}">=<статус почтового ящика>] [& Тип

    Строка

    Значение

    Дата рождения пользователя в формате ГГГГ-ММ-ДД.

    "}}">=<дата рождения>] [& Тип

    Целое число

    Значение

    Пол пользователя.

    Возможные значения:

    • 0 — Не указано.

    • 1 — Муж.

    • 2 — Жен.

    "}}">=<пол>] [& Тип

    Строка

    Значение

    Секретный вопрос.

    "}}">=<секретный вопрос>] [& Тип

    Строка

    Значение

    Ответ на секретный вопрос.

    "}}">=<ответ на секретный вопрос>]

    Заголовки:

    Имя Описание
    PddToken

    Токен PDD.

    Авторизация

    Маркер доступа OAuth.

    Параметры:

    Параметр Тип Значение
    Обязательно
    домен Строка

    Имя домена.

    логин String

    Электронный адрес почтового ящика в формате «[email protected]» или «username».

    Запрос должен передавать только один из параметров: логин или uid .

    uid Целое число

    Идентификатор почтового ящика.

    Получить значение ID можно в ответе на запрос Получить список почтовых ящиков. 9″, «&», «*», «(«, «)», «_», «-«, «+», «:», «;», «, «.»

  • отличаться от имени пользователя.

  • inname Строка

    Имя пользователя.

    fname Строка

    Фамилия пользователя.

    включено Строка

    Указывает, включен ли почтовый ящик.

    Возможные значения:

    Birthday_date String

    Дата рождения пользователя в формате ГГГГ-ММ-ДД.

    пол Целое число

    Пол пользователя.

    Возможные значения:

    • 0 — Не указано.

    • 1 — Муж.

    • 2 — Жен.

    hintq Строка

    Секретный вопрос.

    хинта Строка

    Ответ на секретный вопрос.

    Поиск на yandex.com — SPF-запись

    1.

    Укажите доменное имя

    Введите домен для проверки записи SPF

    2. Укажите IP-адрес (необязательно)

    Введите любой IP-адрес, чтобы проверить, разрешено ли ему отправлять электронные письма с помощью записи SPF.

    Не отображать в недавно выполненных поисковых запросах SPF

    Для чего нужен поиск SPF?

    С помощью поиска SPF вы анализируете запись SPF домена на наличие ошибок, угроз безопасности и разрешенных IP-адресов. При желании вы можете указать IP-адрес, чтобы проверить, авторизован ли он для отправки электронной почты от имени домена. Поиск SPF анализирует зарегистрированные записи TXT в режиме реального времени. Если вы хотите указать запись SPF вручную, используйте Анализатор SPF.

    Загрузка…

    Проверка SPF пройдена

    Результат проверки вашей записи SPF

    •   Найдено запись SPF
    •   Проверка синтаксиса: 0 ошибок
    •   Защита от спуфинга электронной почты: Хорошо

    Сводка проверки SPF

    Существует ли допустимая запись SPF?
    Обнаружена запись SPF для домена yandex.com .
    Запись SPF для yandex.com действительна .
    Проверка синтаксиса записи SPF не выявила очевидных ошибок.

    Какие IP-адреса разрешены для отправки электронной почты?
    Запись SPF содержит ссылку на внешние правила, что означает, что действительность записи SPF зависит как минимум от одного другого домена. Подробный список правил, используемых извне, можно найти в результате анализа. Всего 18 IP-адресов были авторизованы записью SPF для отправки электронных писем.

    Анализ записи SPF был выполнен 12.05.2023 в 22:07:51 часов.

    Полная проверка доставки и безопасности электронной почты

    SPF — это лишь один из многих аспектов.
    Комплексно защитите свой почтовый трафик.

    Подробнее

    Полная проверка доставки и безопасности электронной почты

    Подробнее

    Оценка домена yandex.com 

    Бесплатное ИТ-руководство по управлению рисками безопасного домена запись для домена: yandex.com

    Запись SPF доступна?

    Мы нашли запись SPF для домена.

    v=spf1

    Будет перенаправлен на другую запись SPF?

    Существует запись SPF, которая ссылается на другую запись SPF, поэтому дополнительные записи в этой записи игнорируются.

    редирект:_spf.yandex.ru

    v=spf1 include:_spf-ipv4.yandex.ru include:_spf-ipv6.yandex.ru include:_spf-ipv4-yc.yandex.ru ~all

    include:_spf-ipv4-yc.yandex.ru

    v=spf1 ip4:178.154.239.80/28 ip4:178.154.239.72/29 ip4:178.154.239.144/28 ip4:178.154.239.136/29 ip4:178.154.239.208/28 ip4:178.1 54.239.200/29 ~ все

    IPv4:

    178.154.239.80/28

    IPv4:

    178.154.239.72/29

    IPv4:

    178.154.239. 144/28

    IPv4:

    178.154.239.136/29

    ipv4:

    178.154.239.208/28

    IPv4:

    178.154.239.200/29

    Разрешены ли адреса серверов для отправки электронной почты?

    В записи SPF механизм «a» имеет , а не .

    Дополнительно авторизованные A-записи?

    Помимо A-записей, хранящихся в DNS, мы не смогли найти никаких других записей, авторизованных в SPF-записи.

    Разрешено ли зарегистрированным почтовым серверам отправлять электронную почту?

    В записи SPF механизм «MX» имеет Не . Дополнительно авторизованные IPv4-адреса

    Нет явных IPv4-адресов в записи SPF, которым разрешено отправлять

    Дополнительные авторизованные IPv6-адреса

    Нет явных IPv6-адресов в записи SPF, которые были авторизованы для отправки

    Дополнительные внешние записи SPF

    Нам не удалось найти другие записи, авторизованные в SPF-Record

    900 05 Как дела отправитель проинформирован?

    Механизм exp действует как возврат отправителю, если IP-адрес не авторизован для отправки и уведомления.

    Автор записи

    Добавить комментарий

    Ваш адрес email не будет опубликован. Обязательные поля помечены *