Документация API
Ресурсы и руководства для разработчиков по интеграции QR Cake.
Быстрый старт
API QR Cake позволяет пользователям QR Cake управлять своими QR-кодами в аккаунте.
Аутентификация
Создайте API-ключ в панели управления и передавайте его в заголовке Authorization.
Authorization: Bearer <API Key> Content-Type: application/json
Управляйте ключами API в API-ключах панели управления.
Тестер API-запросов
Проверяйте эндпоинты прямо с этой страницы. Введите API-ключ, выберите эндпоинт и просмотрите ответ в реальном времени.
Интерактивный тестер API
Отправляйте запросы из браузера прямо к выбранному API-эндпоинту QR Cake.
Authorization: Bearer <API Key>https://api.qrcake.com/v1/product/user/product
Терминология
Продукты
QR-коды
Пользователи
аккаунты QR Cake
Тела запроса (POST/PUT)
Для запросов POST и PUT тело запроса должно быть сериализовано в строку. Если вы отправляете JSON, передавайте JSON-строку (например, JSON.stringify(payload)).
const payload = { redirect: "https://example.com", metadata: {} };
await fetch(url, {
method: "POST",
body: JSON.stringify(payload),
});Список QR-кодов
Возвращает список QR-кодов, доступных по этому API-ключу.
Authorization: Bearer <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]{
"message": {}
}Products = QR-коды.
Получить QR-код
Получает один QR-код.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Создать QR-код
Создает новый продукт с QR-кодом.
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Тело POST-запроса должно быть сериализовано в строку (например, JSON.stringify(payload)).
Обновить QR-код
Обновляет существующий QR-код (продукт).
- productId (string)
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"expiresAt": 0,
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Тело PUT-запроса должно быть сериализовано в строку.
Удалить QR-код
Удаляет QR-код.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"productId": "string"
}{
"message": {}
}Разрешения
Возвращает разрешения, предоставленные ключу API.
Authorization: Bearer <API Key>Accept: application/json
{
"success": true,
"result": {
"analytics": true,
"productLimit": 100,
"tier": "subscriber",
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}{
"message": {}
}Поддерживаемые типы QR-кодов
Используйте эти типы метаданных при создании или обновлении QR-продуктов.
redirect, link, image, video, file, pdf, audio, app, event, vCard
Начните с динамических QR-кодов и изменяемых QR-кодов на нашей главной странице.