Бесплатный доступ к API Библиотеке наборов стикеров для телеграм и Вайбер
Чтобы просмотреть записи в библиотеке , отправьте запрос GET к конечной точке библиотеке . Обратите внимание, что имена таблиц и идентификаторы таблиц могут использоваться взаимозаменяемо. Использование идентификаторов таблиц означает, что изменение имени таблицы не требует внесения изменений в ваш запрос API.
Возвращаемые записи не содержат полей с «пустыми» значениями, например " ", [ ]или false.
Вы можете фильтровать, сортировать и форматировать результаты со следующими параметрами запроса. Обратите внимание, что эти параметры должны быть закодированы в URL. Вы можете использовать инструмент кодирования URL-адресов API, чтобы помочь с этим. Если вы используете вспомогательную библиотеку, такую как Airtable.js , эти параметры будут автоматически закодированы.
поля
array of strings
необязательный
В результат будут включены только данные для полей, имена которых есть в этом списке. Если вам не нужно каждое поле, вы можете использовать этот параметр, чтобы уменьшить объем передаваемых данных.
Например, чтобы вернуть данные только из title и Attachments , отправьте эти два параметра запроса:
fields%5B%5D=название&fields%5B%5D=вложения
Вы также можете выполнить то же действие с идентификаторами полей (их можно найти в разделе полей):
поля%5B%5D=fldKqt42Lm8c02odN&поля%5B%5D=fldF3kEPDxVQlcI1E
Примечание: %5B%5D может быть опущен при указании нескольких полей, но всегда должен быть включен при указании только одного поля.
фильтр по формуле
string
необязательный
Формула , используемая для фильтрации записей. Формула будет оцениваться для каждой записи, и если результат не равен 0, false, "", NaN, [ ], или #Error! запись будет включена в ответ.
В сочетании с view параметром будут возвращены только те записи в этом представлении, которые удовлетворяют формуле.
Например, чтобы включить только те записи, в которых заголовок не пуст, передайте в NOT({title} = '') качестве параметра такой пример:
filterByFormula=НЕ%28%7Btitle%7D%20%3D%20%27%27%29
максрекордс
number
необязательный
Максимальное общее количество записей, которое будет возвращено в ваших запросах. Если это значение больше pageSize (которое по умолчанию равно 100), возможно, вам придется загрузить несколько страниц, чтобы достичь этого значения. Дополнительную информацию см. в разделе «Разбивка на страницы» ниже.
размер страницы
number
необязательный
Количество записей, возвращаемых в каждом запросе. Должно быть меньше или равно 100. Значение по умолчанию — 100. См. раздел «Разбивка на страницы» ниже, чтобы узнать больше.
Сортировать
array of objects
необязательный
Список объектов сортировки, указывающий, как будут упорядочены записи. Каждый объект сортировки должен иметь field ключ, определяющий имя поля для сортировки, и необязательный direction ключ, который может быть либо , "asc" либо "desc". Направление по умолчанию "asc".
Параметр sort переопределяет сортировку представления, указанную в view параметре. Если ни параметр, sortни view параметр не включены, порядок записей
Например, чтобы отсортировать записи по заголовку в порядке убывания, отправьте эти два параметра запроса: произвольный.
sort%5B0%5D%5Bполе%5D=название
сортировка% 5B0% 5D% 5Bdirection% 5D = описание
Например, чтобы отсортировать записи по заголовку в порядке убывания, передайте:
[{поле: "название", направление: "описание"}]
Посмотреть
string
необязательный
Имя или идентификатор представления в таблице . Если установлено, будут возвращены только записи в этом представлении. Записи будут отсортированы в соответствии с порядком представления, если sort не включен параметр, который переопределяет этот порядок. Поля, скрытые в этом представлении, будут возвращены в результатах. Чтобы вернуть только подмножество полей, используйте fields параметр.
формат ячейки
string
необязательный
Формат, который следует использовать для значений ячеек. Поддерживаемые значения:
json: ячейки будут отформатированы как JSON, в зависимости от типа поля.
string: ячейки будут отформатированы как строки, обращенные к пользователю, независимо от типа поля. Параметры timeZone и userLocale обязательны при использовании string в качестве cellFormat.
Примечание. Не следует полагаться на формат этих строк, так как он может быть изменен.
Значение по умолчанию json.
часовой пояс
string
необязательный
Часовой пояс , который следует использовать для форматирования дат при использовании string в качестве cellFormat файла . Этот параметр обязателен при использовании string в качестве cellFormat.
пользовательская локаль
string
необязательный
Языковой стандарт пользователя , который следует использовать для форматирования дат при использовании string в качестве файла cellFormat. Этот параметр обязателен при использовании string в качестве cellFormat.
returnFieldsByFieldId
boolean
необязательный
Необязательное логическое значение, позволяющее возвращать объекты полей, где ключом является идентификатор поля.
По умолчанию это значение false, которое возвращает объекты поля, где ключ является именем поля.
Эти параметры должны быть закодированы в URL . Если вы используете вспомогательную библиотеку, такую как Airtable.js , они будут автоматически закодированы.
Пагинация:
Сервер возвращает одну страницу записей за раз. Каждая страница будет содержать pageSize записи, которых по умолчанию 100.
Если записей больше, ответ будет содержать offset. Чтобы получить следующую страницу записей, включите offset в параметры следующего запроса.
Разбиение на страницы остановится, когда вы дойдете до конца таблицы. Если maxRecordsпараметр передан, нумерация страниц прекратится, как только вы достигнете этого максимума.
Итерация может прерваться из-за бездействия клиента или перезапуска сервера. В этом случае клиент получит ответ 422 с сообщением об ошибке LIST_RECORDS_ITERATOR_NOT_AVAILABLE. Затем он может перезапустить итерацию с самого начала.
ПРИМЕР ЗАПРОСА JSON
curl "https://api.airtable.com/v0/appkIw6x7RVjNg45O/stickers?maxRecords=3&view=Grid%20view" \
- H "Authorization: Bearer keydI5gingq9MlcMY"
ПРИМЕР ОТВЕТА JSON
{
"records": [
{
"id": "recfQsiwRf1hkvax0",
"createdTime": "2022-05-09T23:21:54.000Z",
"fields": {
"aftor link": "https://www.instagram.com/nicktolab/",
"Attachments": [
{
"id": "attiRphHDaHnYMxN7",
"width": 325,
"height": 325,
"filename": "648c8e_8adf0f51721844ababda2393cc2dfd56_mv2.webp", "size": 51908,
"type": "image/webp",
"thumbnails": {
"small": {
"width": 36,
"height": 36
},
"large": {
"width": 325,
"height": 325
},
"full": {
"width": 3000,
"height": 3000
}
}
}
],
"kategory": "Девушки/Парни",
"title": " Дьявол и Дьяволица",
"aftor": " Ник Толабов",
"tg": "https://t.me/addstickers/devilanddemoness",
"spisok": [
{
"id": "attzDgAb6ERYvdY6R",
"width": 666,
"height": 2884,
"filename": "648c8e_447b2e9accdf46ffb8c453f700359ec9_mv2.webp",
"size": 992970,
"type": "image/webp",
"thumbnails": {
"small": {
"width": 8,
"height": 36
},
"large": {
"width": 512,
"height": 2217
},
"full": {
"width": 3000,
"height": 3000
}
}
}
],
"like": 43
}
},
{
"id": "recK3UVzyazQ8HJCi",
"createdTime": "2022-05-10T16:06:50.000Z",
"fields": {
"Attachments": [
{
"id": "attqiAOHnmQBoIyy8",
"width": 325,
"height": 325,
"filename": "648c8e_d7dd0743a54842d7924f42da22b8fc4e_mv2.webp",
"size": 46890,
"type": "image/webp",
"thumbnails": {
"small": {
"width": 36,
"height": 36
},
"large": {
"width": 325,
"height": 325
},
"full": {
"width": 3000,
"height": 3000
}
}
}
],
"kategory": "Девушки",
"title": "Девушка Хакер",
"aftor": " paradiSEcurity",
"tg": "https://t.me/addstickers/hackerwomanParadisecurity",
"spisok": [
{
"id": "attn0Uw1vC0tAdwji",
"width": 666,
"height": 913,
"filename": "648c8e_ae314298e0ab4a068498aed5deece4a8_mv2.webp",
"size": 234576,
"type": "image/webp",
"thumbnails": {
"small": {
"width": 26,
"height": 36
},
"large": {
"width": 512,
"height": 702
},
"full": {
"width": 3000,
"height": 3000
}
}
}
],
"like": 43
}
},
{
"id": "recGt1OSxnp1J9p5j",
"createdTime": "2022-05-10T16:09:44.000Z",
"fields": {
"aftor link": "https://www.instagram.com/driganastya/",
"Attachments": [
{
"id": "att8I1aZsdzzHx8kq",
"width": 325,
"height": 325,
"url": "https://dl.airtable.com/.attachments/99f9240e4db8e917db50d9fc565e7916/90e72589/648c8e_0cfbab03ad814caf9d007af9250eb74c_mv2.webp?ts=1652384312&userId=usrOJUs2mvTkuiudW&cs=f3659c7132447dff", "filename": "648c8e_0cfbab03ad814caf9d007af9250eb74c_mv2.webp",
"size": 51042,
"type": "image/webp",
"thumbnails": {
"small": {
"width": 36,
"height": 36
},
"large": {
"width": 325,
"height": 325
},
"full": {
"width": 3000,
"height": 3000
}
}
}
],
"kategory": "Прочии",
"title": "Брауни",
"aftor": " Настя Дрига",
"tg": "https://t.me/addstickers/brownie_vk",
"spisok": [
{
"id": "att5h4VT6XiV82qR6",
"width": 666,
"height": 1462,
"filename": "648c8e_09d7405cffc44ab4af82bdc5e27d4c86_mv2.webp",
"size": 520564,
"type": "image/webp",
"thumbnails": {
"small": {
"width": 16,
"height": 36
},
"large": {
"width": 512,
"height": 1124
},
"full": {
"width": 3000,
"height": 3000
}
}
}
],
"like": 43
}
}
],
"offset": "itr2LQt10HlzVFfim/recGt1OSxnp1J9p5j"
}