Гайды
Миграция API v1 → v2 v200.1.0
Чем v2 отличается от удалённого v1 и как перевести клиента.
С версии 200.1.0 живёт только /api/v2. Старый v1 (заголовок X-Api-Key) удалён. Ниже — что поменять в клиенте.
Было → стало
| API v1 (удалён) | API v2 | |
|---|---|---|
| Путь | /api/v1 | /api/v2 |
| Вход | X-Api-Key (сырой ключ) | Authorization: Bearer <access_token> |
| Токен | — | POST /oauth/token |
| CRUD | отдельные URL | /table/{name}/ + короткие /post/, /user/, … |
| Админка | старая | DevCraft ≥ 200.4.0 |
| PHP внутри сайта | хелперы DLE | DcApi — гайд SDK |
| Документация API | Postman-коллекция | OpenAPI |
Как думать про sugar и /table/: Как работать с эндпоинтами. Как получить Bearer: Авторизация, OAuth-сервер.
Шаги переноса
- Base URL →
/api/v2. Редирект 308 с/apiи/api/v1— это смена префикса, не совместимость старых путей один-в-один. - Убрать
X-Api-Key. Получитьaccess_tokenи слать Bearer. - Переписать эндпоинты: старые
users/auth,users/registerи т.п. → token +/table/…/ sugar/user///me. - Фильтры: query-параметры колонок и
xf[…]— поиск новостей, HTTP. - In-process код →
DcApi. - Проверить scopes ключа — уровни доступа.