v1 vs v2
На этой странице собрана информация о переходе с BotiCord API v1 на BotiCord API v2.
Запросы
В URL запросов укажите v2, вместо v1.
| v1 | V2 |
|---|---|
https://api.boticord.top/v1 |
https://api.boticord.top/v2 |
Авторизация
Как Вам известно для авторизации запросов в BotiCord API используются API-токены. Эта практика остается прежней, но при этом получает небольшие технические изменения.
Напоминаем, что существует 2 вида API-токенов: BOT_TOKEN и USER_TOKEN
(API-Токен бота и API-токен пользователя соответственно)
В BotiCord API v2 к API-токену необходимо добавлять приписку:
| (BotiCord API) v1 | (BotiCord API) v2 | Описание |
|---|---|---|
{BOT_TOKEN} |
Bot {BOT_TOKEN} |
API-токен бота. Используется чаще всего. |
{BOT_TOKEN} |
PrivateBot {BOT_TOKEN} |
API-токен бота. Используется в приватных случаях (например: Ап сервера, если у вас не сервисный бот) |
{USER_TOKEN} |
Profile {USER_TOKEN} |
API-токен пользователя. Используется в Методах Сокращения Ссылок. |
Доступ к методам
Немного изменился список прав доступа к методам. (Некоторые токены подходят теперь и к другим методам)
| Тип | Метод | Bot | PrivateBot | Profile |
|---|---|---|---|---|
| GET | /v2/server/:serverID/validateBot/:botID |
✅ | ✅ | ✅ |
| GET | /v2/bots/:developerID |
✅ | ✅ | ✅ |
| GET | /v2/bot/:botID/comments |
✅ | ✅ | ✅ |
| GET | /v2/server/:serverID/comments |
✅ | ✅ | ✅ |
| GET | /v2/profile/:userID/comments |
✅ | ✅ | ✅ |
| POST | /v2/stats |
✅ | ❌ | ❌ |
| POST | /v2/server |
✅ (ТРЕБУЕТСЯ БЫТЬ СЕРВИСНЫМ БОТОМ) | ✅ (только на разрешённых пяти серверах) | ❌ |
| POST | /v2/links/get |
❌ | ❌ | ✅ |
| POST | /v2/links/create |
❌ | ❌ | ✅ |
| POST | /v2/links/delete |
❌ | ❌ | ✅ |
| GET | /v2/token |
✅ | ✅ | ✅ |
Если метод не указан в этом списке, то в BotiCord API v2 указания токена не требуется.
Материал будет дополняться.