POST personal_contacts.upsert
Назначение: сохранить пользователя из личного чата, если у него нет активной прямой подписки на бота.
Контур: внутренний сервисный endpoint (не внешний gateway).
POST http://127.0.0.1:17082/api/personal_contacts
Параметры метода
Query (обязательно): project, api_key.
Body JSON:
{
"chat_id": 123456789,
"username": "user_name",
"name": "Иван Иванов",
"birth_date": "1990-02-15"
}
Обработка ответа
200—{"ok":"saved"}400— неверный JSON или пустойchat_id401— неверныеproject/api_key500— ошибка БД
Пример (Python)
import requests
url = 'http://127.0.0.1:17082/api/personal_contacts'
params = {'project': 'talkiq', 'api_key': 'YOUR_API_KEY'}
payload = {'chat_id': 123456789, 'username': 'user_name', 'name': 'Иван Иванов', 'birth_date': '1990-02-15'}
response = requests.post(url, params=params, json=payload, timeout=15)
response.raise_for_status()
print(response.json())