Technical Support Engineer (L2) | Technical Writer
Разбираю, как ведёт себя API на самом деле: воспроизвожу ошибки, читаю логи, нахожу причину и объясняю её партнёру или разработчику. Пишу документацию по API и интеграциям в подходе Docs-as-Code.
Telegram · flavrinets@gmail.com
Платёжный API Яндекс Пэй, проверенный запросами в тестовой среде (Sandbox): оплата, полный и частичный возврат, разбор ошибок партнёра.
- Поддержка (L2): 12 ошибок и граничных случаев воспроизведены в Sandbox, по каждому сохранён лог запроса и ответа. Найдено 9 мест, где ответы API расходятся с документацией или не описаны в ней.
- Документация: руководство по сквозному тестированию, разбор частичного возврата, справочники статусов и ошибок, sequence-диаграмма.
- Стек: REST API, Postman, curl, JSON, вебхуки с подписью JWT, MkDocs Material, Mermaid, GitHub Actions.
С чего начать:
- Отличия Sandbox от документации: что API делает не так, как написано, и что это значит для магазина;
- Коды ошибок: код → причина → что проверить, со ссылкой на лог воспроизведения;
- Разбор обращения «на форме доступен только Сплит»: симптом, диагностика запроса, ответ партнёру.
Доставка вебхуков Telegram на Linux-сервер: Nginx как обратный прокси, TLS, проверка секретного токена, диагностика сбоев.
- Поддержка (L2): разбор ошибок доставки по ответу
getWebhookInfoи логам Nginx (403,502,504, проблемы с сертификатом и портами), проверка жизненного цикла вебхука коллекцией Postman с автотестами. - Документация: how-to по настройке сервера, спецификация OpenAPI 3.0 со Swagger UI, глоссарий, архитектурная схема.
- Стек: Linux, Nginx, TLS, Bash, Postman, OpenAPI 3.0, MkDocs Material, Draw.io, GitHub Actions.
С чего начать:
- Настройка и устранение неполадок: от конфигурации Nginx до разбора ошибок доставки;
- Спецификация OpenAPI в Swagger UI.
- API и диагностика: REST, HTTP (методы, заголовки, коды ответа), JSON, вебхуки, Postman, curl, воспроизведение ошибок, сверка поведения API с документацией.
- Linux и сеть: администрирование VPS, SSH, systemd, UFW, Nginx (обратный прокси, TLS), логи
access.logиerror.log,ss,curl,openssl. - Документация: Markdown, Docs-as-Code, MkDocs Material, OpenAPI 3.0, Swagger UI, Diátaxis, Mermaid, Draw.io, собственный стайлгайд.
- Инструменты: Git, GitHub Actions (линтинг, проверка ссылок и JSON, сборка и деплой документации).
- Сейчас изучаю: SQL — запросы для диагностики заказов и платежей.