Sat Feb 22 2025
...

Выпущен новый Aggregation API

! Эта статья содержит техническую терминологию

Что нового

FastComments предоставляет своим клиентам непревзойденный доступ к их данным с помощью гибкого Aggregation API. Этот API позволяет вам подсчитывать, исследовать, сегментировать и агрегировать ваши комментарии, голосования и 34 других ресурса!

Пример - Подсчет комментариев по электронной почте и странице

Например, с помощью нового API мы можем получить количество комментариев по странице (urlId) и электронной почте пользователя (commenterEmail):

curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --data '{ "resourceName": "Comment", "operations": [ { "op": "distinct", "field": "urlId", "alias": "urlId" }, { "op": "distinct", "field": "commenterEmail", "alias": "commenterEmail" } ] }' --header 'Content-Type: application/json'

Это вернет нам что-то вроде:

{ "status": "success", "data": [ { "commenterEmail": { "distinctCounts": { "someone@somewhere.com": 1, "someone2@somewhere.com": 1 } } }, { "urlId": { "distinctCounts": { "some-page": 2 } } } ], "stats": { "scanned": 2 } }

Или, возможно, мы хотим подсчитать наши одобренные и неодобренные комментарии:

curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --data '{ "resourceName": "Comment", "operations": [ { "op": "distinct", "field": "approved", "alias": "approved" }, ] }' --header 'Content-Type: application/json'

Это даст нам:

{ "status": "success", "data": [ { "approved": { "distinctCounts": { "true": 2200, "false": 231 } } } ], "stats": { "scanned": 2431 } }

API также поддерживает фильтры запросов и более глубокую группировку.

Документация

Полную документацию можно найти здесь.

Мотивация

Мы хотим, чтобы наши клиенты могли создавать панели мониторинга для отслеживания своих учетных записей, составлять отчеты, обрабатывать запросы клиентов и исследовать свои данные по мере необходимости.

Кто получает доступ и ограничения

Все клиенты FastComments имеют доступ к API. Ваше использование ограничено на основе ваших доступных API кредитов, которые могут варьироваться в зависимости от пакета, который вы приобрели.

В заключение

Как и в случае с любыми крупными релизами, мы рады, что смогли уделить время на оптимизацию, тестирование и правильный выпуск этих изменений. Сообщите нам ниже, если вы обнаружите какие-либо проблемы.

Всего хорошего!

Sat Feb 22 2025...