Обзор

С помощью Threads API вы можете предоставлять пользователям возможность создавать и публиковать контент от их имени в Threads, а также показывать эти публикации в своем приложении (только пользователю, создавшему публикацию).

Ограничение числа обращений

Публикации

Для профилей Threads действует ограничение: не более 250 публикаций через API в течение скользящего 24-часового периода. Кольцевые галереи считаются одной публикацией. Это ограничение применяется на конечной точке POST /{threads-user-id}/threads_publish при попытке опубликовать медиаконтейнер. Желательно, чтобы приложение также ограничивало количество публикаций, особенно если оно позволяет пользователям планировать их размещение в будущем.

Чтобы узнать, какая часть ограничения числа обращений через Threads API уже использована, выполните запрос к конечной точке GET /{threads-user-id}/threads_publishing_limit.

Примечание. Для этой конечной точки необходимы разрешения threads_basic и threads_content_publish.

Поля

Пример запроса

curl -s -X GET \
  "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"

Пример ответа

{
  "data": [
    {
      "quota_usage": 4,
      "config": {
        "quota_total": 250,
        "quota_duration": 86400
      }
    }
  ]
}

Ответы

Для профилей Threads действует ограничение: не более 1 000 ответов в рамках скользящего 24-часового окна.

Чтобы узнать, какая часть ограничения числа ответов в Threads уже использована, выполните запрос к конечной точке GET /{threads-user-id}/threads_publishing_limit. Подробнее см. в документации по управлению ответами.

Примечание. Для этой конечной точки необходимы разрешения threads_basic, threads_content_publish и threads_manage_replies.

Поля

Пример запроса

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=reply_quota_usage,reply_config&access_token=<ACCESS_TOKEN>"

Пример ответа

{
  "data": [
    {
      "reply_quota_usage": 1,
      "reply_config": {
        "quota_total": 1000,
        "quota_duration": 86400
      }
    }
  ]
}

Удаление

Для профилей Threads действует ограничение: не более 100 удалений в рамках скользящего 24-часового окна.

Чтобы узнать, какая часть ограничения числа удалений в Threads уже использована, выполните запрос к конечной точке GET /{threads-user-id}/threads_publishing_limit. Подробнее см. в документации по удалению публикаций.

Примечание. Для этой конечной точки необходимы разрешения threads_basic и threads_delete.

Поля

Пример запроса

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=delete_quota_usage,delete_config&access_token=<ACCESS_TOKEN>"

Пример ответа

{
  "data": [
    {
      "delete_quota_usage": 1,
      "delete_config": {
        "quota_total": 100,
        "quota_duration": 86400
      }
    }
  ]
}

Поиск местоположений

Для профилей Threads действует ограничение: не более 500 поисков местоположений в течение скользящего 24-часового периода.

Чтобы узнать, какая часть ограничения числа поисков местоположений в Threads уже использована, выполните запрос к конечной точке GET /{threads-user-id}/threads_publishing_limit. Подробнее см. в документации по поиску местоположений.

Примечание. Для этой конечной точки необходимы разрешения threads_basic и threads_location_tagging.

Поля

Пример запроса

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=location_search_quota_usage,location_search_config&access_token=<ACCESS_TOKEN>"

Пример ответа

{
  "data": [
    {
      "location_search_quota_usage": 1,
      "location_search_config": {
        "quota_total": 500,
        "quota_duration": 86400
      }
    }
  ]
}

Ограничения и технические требования

Другие ограничения

• Максимальная длина текстовой публикации — 500 символов.
• Кольцевые галереи должны содержать от 2 до 20 дочерних элементов.
• Дополнительные ограничения см. в справке по каждой конечной точке.

Дальнейшие действия

• Начало работы с Threads API