Настройки DigiKey API
DigiKey — третий провайдер поиска по MPN, работающий через каталог дистрибьютора DigiKey Electronics. Он полезен как дополнение к Nexar и Mouser: у разных дистрибьюторов различаются описания, наборы характеристик и наличие даташитов, поэтому включённые вместе провайдеры чаще дают полную карточку компонента.
Открытие настроек
Откройте меню Настройки > DigiKey API... Откроется диалог Настройки DigiKey API.
Настройка
- Установите флажок Включить DigiKey — без него провайдер не участвует в поиске, даже если ключи введены.
- Заполните поля:
- Client ID — идентификатор приложения, созданного в портале разработчика DigiKey
- Client Secret — секретный ключ приложения (отображается как пароль)
- Задайте Максимум результатов — сколько компонентов провайдер вернёт на один запрос (от 1 до 50, по умолчанию 20).
- Нажмите Проверить, чтобы убедиться, что ключи рабочие. Результат появится под кнопкой.
- Нажмите OK — все четыре значения сохраняются одновременно. Кнопка Отмена, клавиша Esc и закрытие окна не сохраняют ничего.
Примечание: Проверка ключей не обязательна и не блокирует сохранение — настройки можно записать и без неё.
Проверка ключей
Кнопка Проверить становится доступной, когда заполнены оба поля, и проверяет именно тот текст, который вы видите на экране, а не ранее сохранённые значения. Возможны три ответа:
| Результат | Что означает |
|---|---|
| Ключи приняты | Client ID и Client Secret верны. Работа поиска дополнительно зависит от статуса приложения в портале DigiKey: оно должно быть создано как Production App с подключённым Product Information API |
| Ключи не приняты | DigiKey отклонил пару ключей — проверьте, что вы скопировали их полностью и без пробелов |
| Сервис недоступен или ответил некорректно | Проверку не удалось завершить: нет связи, истекло время ожидания или сервис ответил ошибкой. Повторите попытку позже |
Как только вы правите любое из полей, прежний результат исчезает — он относился к другим ключам, а незавершённая проверка отменяется, и кнопку Проверить можно нажать снова.
Получение ключей
Нажмите Как получить ключи? — раскроется пошаговая инструкция со ссылками, которые открываются в браузере. Кратко порядок такой:
- Зарегистрируйтесь на developer.digikey.com — это отдельная регистрация, учётная запись интернет-магазина digikey.com не подойдёт. При входе примите все cookies, иначе портал отвечает «Access Denied» без объяснения причины.
- Создайте организацию.
- Во вкладке Production Apps нажмите + Create Production App. Приложение sandbox не подойдёт — его данные для поиска непригодны.
- В списке API отметьте ProductInformation V4.
- В обязательное поле OAuth Callback впишите
https://localhost— приложению это поле не нужно, но форма без него не сохранится. - Client ID и Client Secret будут показаны на странице созданного приложения.
Ошибки при поиске
Если провайдер настроен, но поиск не удался, сообщение показывается прямо в результатах — под заголовком группы DigiKey:
- «Ключи не приняты — проверьте Client ID и Client Secret» — ключи неверны или отозваны; откройте этот диалог и нажмите Проверить.
- «Ключи приняты, но доступ к данным закрыт — проверьте статус приложения в портале разработчика» — самая частая причина: приложение создано как sandbox либо к нему не подключён Product Information API.
- «Сервис недоступен или ответил некорректно — повторите попытку позже» — нет связи, превышено время ожидания или сервис вернул неожиданный ответ.
Ошибка одного провайдера не прерывает поиск: результаты остальных включённых провайдеров отображаются как обычно.