Informationen zu API-Schlüsseln | Mailchimp
В diesem Artikel erfährst du, был eine API ist, wie du anderen mit einem API-Schlüssel Zugang zu deinem Mailchimp-Account gewährst und an wen du dich im Falle von zusätzlichen Fragen zur Mailchimp-Marketing-API wenden kannst.
Hinweis
Die Informationen in diesem Artikel beziehen sich nur auf API-Schlüssel, die mit der Mailchimp-Marketing-API verknüpft sind. Здесь содержится информация об Einsatz der API-Schlüssel für die Mailchimp Transactional API (Mailchimp-Transaktions-API), найденная в Kurzanleitung für Transaktions-API
Был ли истинный API?
API Steht for Application Programming Interface, auf Deutsch auch Programmierschnittstelle genannt. Das Konzept einer API kann ganz einfach erklärt werden: Stell dir einfach vor, dass sich verschiedene Apps über eine API miteinander austauschen können. Die meisten Benutzer verwenden hauptsächlich die API-Schlüssel der API. Dadurch erhalten andere Apps Zugriff auf deinen Account, ohne dass du dein Passwort weitergeben musst.
API-Шлюссель генерирэн
Höchstwahrscheinlich musst du bei der Integration mit deinem Mailchimp-Account einen API-Schlüssel erstellen. Benutzer mit Berechtigungen als Manager können eigene API-Schlüssel erstellen und anzeigen. Benutzer mit Admin-Berechtigungen können außerdem die von Anderen Account-Benutzern genericerten API-Schlüssel sehen.
Hinweis
Der vollständigen API-Schlüssel wird dir nur unmittelbar nach der Generierung angezeigt. Danach siehst du nur noch den von dir ausgewählten Namen und die ersten 4 Ziffern des Schlüssels.
Общий номер API-Schlüssel:
- Navigiere in deinem Account zum Abschnitt
- Нажмите на Create Journey (Journey erstellen).
- Gib dem Schlüssel einen aussagekräftigen Namen, damit du später weißt, welche App ihn verwendet. Denke daran, dass du nach dem Generieren des Schlüssels nur diesen Namen und die ersten vier Ziffern auf deiner Liste der API-Schlüssel sehen wirst.
- Щелчок на Генерация ключа (генерирование Schlüssel).
- Sobald wir deinen Schlüssel generiert haben, click auf Copy Key to Clipboard
- Нажмите на Готово (Фертиг) .
Einen API-Schlüssel für ungültig erklären
Du kannst einen API-Schlüssel für ungültig erklären, wenn du befürchtest, dass er manipuliert wurde, oder du die Integration, die mit ihm auf deinen Account zugegriffen hat, nicht mehr nutzt. Sobald du einen API-Schlüssel für ungültig erklärt hast, kann er nicht wieder aktiviert werden. Du musst einen neuen Schlüssel generieren und mit diesem alle Integrationen aktualisieren.
So erklärst du einen API-Schlüssel für ungültig:
- Navigiere in deinem Account zum Abschnitt Ключи API (API-Schlüssel).
- Такой код API-Schlüssel, указанный для унгюльтиг erklären möchtest, и нажмите на Revoke (для ungültig erklären).
- Gib im Pop-up-Dialogfenster REVOKE ein und click danach auf Revoke (für ungültig erklären), um den Vorgang zu bestätigen.
Sicherheit der API-Schlüssel
API-Schlüssel gewähren vollen Zugriff auf deinen Mailchimp-Account und sollten daher genauso gut geschützt werden wie ein Passwort. Wenn du API-Schlüssel verwendest, solltest du einige gängige Szenarien beachten.
- Weise jeder Integration einen eigenen API-Schlüssel und jedem Schlüssel ein Label zu, damit du später weißt, zu welcher App er gehört. Wenn ein bestimmter API-Schlüssel manipuliert wurde, kannst du ihn für ungültig erklären, ohne den Zugang zu allen anderen Integrationen zu sperren.
- Du solltest den Schlüssel niemals öffentlich zugänglich machen (это в скриншоте, видео или в документации).
- Свободный доступ к API-шлюзам учетных записей, включающих в себя использование рисунков, wird die clienteitige Implementierung unserer API über CORS-Anfragen oder die Einbindung von API-Schlüsseln in mobile Apps von Mailchimp nicht unterstützt.
- Wenn du einen Schlüssel freigegeben musst, solltest du dafür gegebenenfalls einen neuen Schlüssel mit Label erstellen, um den alten Schlüssel für ungültig erklären zu können. Отправляйте ссылки на API-шлюзы для электронной почты, da im Falle eines Hacker-Angriffs на E-Mail-Konto auch dein Mailchimp-Account gefährdet ist.
- Wenn du einem Benutzer mit Zugriff auf deinen Mailchimp-Account die Zugriffsrechte entziehst, werden alle API-Schlüssel, die von diesem Benutzer erstellt wurden, autotisch aus deinem Account gelöscht.
- Der Zugriff auf den jeweiligen Endpunkt hängt von der Rolle des Benutzers ab, der den API-Schüssel generiert hat. Weitere Informationen цу ден Berechtigungen auf Benutzerebene findest du unter Benutzerrechte in deinem Account verwalten.
Weitere Informationen цу ден Berechtigungen auf Benutzerebene findest du unter Benutzerrechte in deinem Account verwalten. API-Unterstützung
Unser Mailchimp-Support-Team ist nicht in der detailslierten API-Fehlerbehebung geschult. Wenn du Hilfe mit der Konfiguration der API benötigst, kannst du über unser Expertenverzeichnis einen externen Mailchimp-Experten beauftragen.
Wenn du ein Webentwickler Bist und Deine Eigene Integration mit Mailchimp softwaremieren willst, findest du in unserer API-Documentation einige nützliche Tipps.
Marketing API: краткое руководство по началу работы
В этом руководстве вы найдете все необходимое, чтобы начать использовать Mailchimp Marketing API для управления аудиториями, управления рабочими процессами автоматизации, синхронизации активности электронной почты с вашей базой данных и многого другого. Мы рассмотрим создание вашего ключа API, установку клиентской библиотеки для предпочитаемого вами языка и выполнение вашего первого вызова API — простого запроса к конечной точке Ping.
Если у вас еще нет учетной записи Mailchimp, вам необходимо создать ее , чтобы использовать API.
Самый простой способ аутентифицировать запрос к Marketing API — использовать ключ API .
Вот как вы можете создать его для себя:
Перейдите в раздел API-ключей вашей учетной записи Mailchimp.
Нажмите Создать новый ключ и дайте ему описательное имя, которое будет напоминать вам, для какого приложения он используется. Немедленно скопируйте сгенерированный ключ и сохраните его в безопасном месте. Вы не сможете увидеть или скопировать ключ после его создания.
Примечание . Важно помнить, что ваш API-ключ Mailchimp обеспечивает полный доступ к учетной записи, поэтому вы должны обеспечить его безопасность, как если бы вы использовали пароль. Из-за потенциальных рисков безопасности, связанных с раскрытием ключей API учетной записи, Mailchimp не поддерживает вызовы API Marketing на стороне клиента с использованием запросов CORS, а ключи API не должны использоваться в мобильных приложениях.
Если вы создаете интеграции, требующие доступа к Mailchimp от имени других пользователей Mailchimp, вам потребуется вместо этого настройте аутентификацию через Oauth 2 .
Вы можете выполнять вызовы Marketing API любым методом, который вы обычно используете для выполнения HTTP-запросов, но Mailchimp предлагает клиентских библиотек , которые еще больше упрощают взаимодействие с API.
Чтобы установить клиентскую библиотеку для предпочитаемого вами языка:
# Установка клиента не требуется; просто используя curl
Чтобы проверить, что у вас все настроено правильно, мы сделаем простой запрос к конечной точке Ping. Нажатие на эту конечную точку действует как проверка работоспособности службы API Mailchimp; это никак не повлияет на вашу учетную запись.
Чтобы найти значение параметра server , используемого в mailchimp.setConfig , войдите в свою учетную запись Mailchimp и посмотрите URL-адрес в браузере.