Многопартнерские решения WhatsApp Business — API отклонения решений | Документация для разработчиков

Многопартнерские решения WhatsApp Business - API для отклонения решений

Экземпляр для программы магистратуры (LLM)

Версия

API для отклонения запросов на партнерство в рамках многопартнерских решений или запросов на деактивацию.

Эта конечная точка позволяет партнерам по решениям отклонять ожидающие рассмотрения запросы на партнерство или деактивацию

запросы на многопартнерские решения.

База URL

~~https://graph.facebook.com~~

Конечные точки

~~ПОЧТА~~

~~/{Версия}/{Идентификатор решения}/reject~~

POST /{Version}/{Solution-ID}/reject

Отклонить ожидающий рассмотрения запрос на партнерство или запрос на деактивацию решения для нескольких партнеров.

Эта конечная точка позволяет владельцам решений отклонять входящие запросы и сохранять контроль

в рамках партнерских отношений и на протяжении всего жизненного цикла их решений.

Варианты использования:

Отклонять запросы на партнерство от неавторизованных или несовместимых приложений

Отклоняйте запросы на деактивацию, чтобы решения оставались активными

Поддерживайте безопасность решений и качество партнерских отношений

Контроль доступа к решению и границ взаимодействия

Типы запросов:

PARTNERSHIP_REQUEST: Отклонить входящий запрос на партнерство от другого приложения.

DEACTIVATION_REQUEST: Отклонен запрос на деактивацию решения.

Ограничение скорости запросов:

Применяются стандартные ограничения скорости запросов к Graph API. Используйте соответствующую логику повторных попыток с экспоненциальной задержкой.

Бизнес-логика:

Отклонять запросы на использование своих решений могут только владельцы решений

Для отклонения партнерских соглашений необходим параметр partner_app_id

Отклонение запроса является необратимым и не может быть отменено через этот API

Отклонённые запросы, возможно, потребуется повторно отправить по надлежащим каналам

Синтаксис запроса

POST /{Версия}/{Идентификатор решения}/reject

Попробуйте!

Выберите язык

локон--запрос ПОЧТА \
--url'https://graph.facebook.com/{Version}/{Solution-ID}/отклонять' \
--заголовок«Авторизация: Предъявитель»<Token> ' \
--заголовок'Content-Type: application/json' \
--данные'{
  "request_type": "PARTNERSHIP_REQUEST",
  "partner_app_id": "9876543210987654",
  "rejection_reason": "Условия партнерства не всесоответствует нашим бизнес-требованиям
}'

Выберите код состояния

{
"Партнерство отклонено": {
"краткое содержание": «Запрос на партнерство отклонен»,
"ценить": {
"успех": истинный,
"solution_id": "1234567890123456",
"rejected_request_type": "ЗАПРОС НА ПАРТНЕРСТВО",
"rejection_timestamp": "2024-01-15T10:30:00Z",
"partner_app_id": "9876543210987654"
    }
  },
"deactivation_rejected": {
"краткое содержание": "Запрос на деактивацию отклонен",
"ценить": {
"успех": истинный,
"solution_id": "1234567890123456",
"rejected_request_type": "ЗАПРОС НА ДЕАКТИВАЦИЮ",
"rejection_timestamp": "2024-01-15T10:30:00Z"
    }
  }
}

Параметры заголовка

User-AgentСтрока

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

авторизацииСтрока·обязательный

Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.

Параметры пути

версииСтрока·обязательный

Версия Graph API, используемая для этого запроса. Определяет поведение API и доступные функции.

идентификатора решенияСтрока·обязательный

Идентификатор вашего многопартнерского решения. Этот идентификатор присваивается при создании решения

и их можно найти в вашей партнерской панели или через API управления решениями.

Текст запросаНеобходимый

Тип содержимого: application/json

Схема: SolutionRejectRequest

Показать дочерние атрибуты

SolutionRejectRequest

request_typeОдин из "PARTNERSHIP_REQUEST", "DEACTIVATION_REQUEST"·обязательный

Тип отклоненного запроса

rejection_reasonstring

Причина отклонения запроса (необязательно)

partner_app_idstring

Идентификатор приложения запрашивающего партнера. Обязательно, если request_type имеет значение PARTNERSHIP_REQUEST, не используется для DEACTIVATION_REQUEST

Ответы

Эта конечная точка позволяет владельцам решений отклонять входящие запросы и сохранять контроль

в рамках партнерских отношений и на протяжении всего жизненного цикла их решений.

Варианты использования:

Отклонять запросы на партнерство от неавторизованных или несовместимых приложений

Отклоняйте запросы на деактивацию, чтобы решения оставались активными

Поддерживайте безопасность решений и качество партнерских отношений

Контроль доступа к решению и границ взаимодействия

Типы запросов:

PARTNERSHIP_REQUEST: Отклонить входящий запрос на партнерство от другого приложения.

DEACTIVATION_REQUEST: Отклонен запрос на деактивацию решения.

Ограничение скорости запросов:

Бизнес-логика:

Отклонять запросы на использование своих решений могут только владельцы решений

Для отклонения партнерских соглашений необходим параметр partner_app_id

Отклонение запроса является необратимым и не может быть отменено через этот API

Отклонённые запросы, возможно, потребуется повторно отправить по надлежащим каналам

200

Запрос на многопартнерское решение был успешно отклонен

Тип содержимого: application/json

Схема: SolutionRejectResponse

Показать дочерние атрибуты

SolutionRejectResponse

успехлогическое значение·обязательно

Указывает, был ли отказ успешным

solution_idстрока·обязательный

Идентификатор многопартнерского решения

rejected_request_typeОдин из "PARTNERSHIP_REQUEST", "DEACTIVATION_REQUEST"·required

Тип отклоненного запроса

rejection_timestampstring (date-time)

Отметка времени по стандарту ISO 8601, когда был обработан отказ

partner_app_idstring

Идентификатор приложения партнера, чей запрос был отклонен (в случае отклонения партнерских заявок)

400

Неверный запрос — недопустимые параметры или некорректный формат запроса

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

401

Несанкционированный доступ - Недействительный или отсутствующий токен доступа

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

403

Запрещено — Недостаточные права доступа или нет, владелец решения

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

404

Решение не найдено — идентификатор решения не существует или запрос не найден

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

422

Необрабатываемый объект — Запрос не может быть обработан из-за ограничений бизнес-логики

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

429

Слишком много запросов — превышен лимит запросов

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

500

Внутренняя ошибка сервера — Неожиданная ошибка сервера

Тип содержимого: application/json

Schema: GraphAPIError

Показать дочерние атрибуты

GraphAPIError

ошибкиобъект·обязательный

Показать дочерние атрибуты

сообщениястрока·обязательный

Удобочитаемое сообщение об ошибке

типстрока·обязательный

Тип категории ошибки

кодцелое число·обязательный

Числовой код ошибки

error_subcodeinteger

Более подробный подкод ошибки, если он доступен

fbtrace_idстрока

Уникальный идентификатор для запросов на отладку и поддержку в Meta

is_transientлогическое значение

Указывает, является ли эта ошибка временной и следует ли повторить запрос

error_user_titleстрока

Удобный для пользователя заголовок сообщения об ошибке для наглядности

error_user_msgстрока

Удобное для пользователя сообщение об ошибке для отображения

Выберите язык

локон--запрос ПОЧТА \
--url'https://graph.facebook.com/{Version}/{Solution-ID}/отклонять' \
--заголовок«Авторизация: Предъявитель»<Token> ' \
--заголовок'Content-Type: application/json' \
--данные'{
  "request_type": "PARTNERSHIP_REQUEST",
  "partner_app_id": "9876543210987654",
  "rejection_reason": "Условия партнерства не всесоответствует нашим бизнес-требованиям
}'

Выберите код состояния

{
"Партнерство отклонено": {
"краткое содержание": «Запрос на партнерство отклонен»,
"ценить": {
"успех": истинный,
"solution_id": "1234567890123456",
"rejected_request_type": "ЗАПРОС НА ПАРТНЕРСТВО",
"rejection_timestamp": "2024-01-15T10:30:00Z",
"partner_app_id": "9876543210987654"
    }
  },
"deactivation_rejected": {
"краткое содержание": "Запрос на деактивацию отклонен",
"ценить": {
"успех": истинный,
"solution_id": "1234567890123456",
"rejected_request_type": "ЗАПРОС НА ДЕАКТИВАЦИЮ",
"rejection_timestamp": "2024-01-15T10:30:00Z"
    }
  }
}

Аутентификация

Схема

Тип

Расположение

bearerAuth

HTTP Bearer

Заголовок: Авторизация

Примеры использования

bearerAuth:

Включите Authorization: Bearer your-token-here в заголовки запроса.

Глобальные требования к аутентификации

Для работы всех конечных точек требуется:

bearerAuth