Руководство по использованию

Документация API открытой платформы

Путь

Dashboard -> Open -> Token Manage

Часто используемые адреса

Адрес API-запроса

  • Growth: https://domain-open-api.getmx.com
  • Scale: Scale использует выделенный сервер; адрес нужно получить в панели управления. Путь получения: dashboard -> domain-email -> email-manage -> api-information, снимок экрана ниже:
    ScaleAPI
  • Single-Domain Scale: API-адрес для запросов у каждого домена отличается
  • Multi-Domain Scale: в рамках одной платной группы API-адрес для всех доменов одинаков

Токен

Генерация токена

  • Нажмите ссылку Генерация токена выше
  • Нажмите кнопку Сбросить токен, чтобы сгенерировать токен для API-запросов
    Token生成
  • Токен поддерживает только сброс; повторный просмотр не поддерживается
  • После сброса предыдущий токен немедленно становится недействительным

Безопасность токена

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

Частые вопросы

API-запрос сообщает об отсутствии токена?

  • В первую очередь проверьте три пункта:
    • POST-запрос
    • Формат запроса — form
    • Параметры запроса должны передаваться в form-форме; в зависимости от языка это не обязательно означает добавление их к ссылке
  • Ознакомьтесь с официальными demo на других языках; если всё равно не получается, скачайте Postman и смоделируйте запрос для отладки.
    API请求postman

Почему не удается получить письма через API-интерфейс?

  • Проверьте вопрос со временем: в API выбор времени осуществляется по дням. Если выбран текущий день, увеличьте дату на один день. Например, если end_time установлен на 2021-05-01, это означает 2021-05-01 00:00:00; чтобы запросить данные за 2021-05-01, установите 2021-05-02