{"openapi":"3.1.0","info":{"title":"BINCORT Public API","version":"v1","description":"Публичный API для интеграций: выгрузка заявок в CRM, вебхуки о событиях, действия над заявками. Человекочитаемая документация: https://api.bincort.ru/v1/docs"},"servers":[{"url":"https://api.bincort.ru"}],"paths":{"/v1/leads":{"get":{"tags":["crm-api"],"summary":"Выгрузить заявки (инкрементально, по since)","description":"Возвращает заявки бизнеса для синхронизации с CRM.\n\nПример запроса:\n    GET /v1/leads?since=2026-05-01T00:00:00Z&limit=100\n    X-CRM-API-Key: bic_crm_xxxxx\n\nРекомендуемая схема опроса: каждые 5–15 минут, передавать since=<дата последнего успешного запроса>.","operationId":"get_leads_for_crm_v1_leads_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 datetime (UTC). Вернуть заявки, созданные после этой даты.","title":"Since"},"description":"ISO 8601 datetime (UTC). Вернуть заявки, созданные после этой даты."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Количество записей (макс. 500).","default":100,"title":"Limit"},"description":"Количество записей (макс. 500)."},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Фильтр по статусу: new, in_progress, completed, spam.","title":"Status"},"description":"Фильтр по статусу: new, in_progress, completed, spam."},{"name":"mark_exported","in":"query","required":false,"schema":{"type":"boolean","description":"Отметить полученные заявки как экспортированные в CRM.","default":false,"title":"Mark Exported"},"description":"Отметить полученные заявки как экспортированные в CRM."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}},"/v1/webhooks/subscribe":{"post":{"tags":["crm-api"],"summary":"Подписаться на событие","operationId":"subscribe_webhook_v1_webhooks_subscribe_post","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscribeRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["crm-api"],"summary":"Отписаться","operationId":"unsubscribe_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}},"/v1/webhooks":{"get":{"tags":["crm-api"],"summary":"Список подписок","operationId":"list_webhooks_v1_webhooks_get","parameters":[],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}},"/v1/leads/{lead_id}/status":{"post":{"tags":["crm-api"],"summary":"Сменить статус заявки","operationId":"v1_change_lead_status_v1_leads__lead_id__status_post","parameters":[{"name":"lead_id","in":"path","required":true,"schema":{"type":"integer","title":"Lead Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}},"/v1/leads/{lead_id}/note":{"post":{"tags":["crm-api"],"summary":"Добавить внутреннюю заметку","operationId":"v1_add_lead_note_v1_leads__lead_id__note_post","parameters":[{"name":"lead_id","in":"path","required":true,"schema":{"type":"integer","title":"Lead Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}},"/v1/leads/{lead_id}/assign":{"post":{"tags":["crm-api"],"summary":"Назначить оператора","operationId":"v1_assign_lead_v1_leads__lead_id__assign_post","parameters":[{"name":"lead_id","in":"path","required":true,"schema":{"type":"integer","title":"Lead Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CrmApiKey":[]}]}}},"components":{"schemas":{"AssignRequest":{"properties":{"operator_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operator Id"}},"type":"object","title":"AssignRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"NoteRequest":{"properties":{"text":{"type":"string","maxLength":4000,"minLength":1,"title":"Text"}},"type":"object","required":["text"],"title":"NoteRequest"},"StatusUpdateRequest":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"StatusUpdateRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebhookSubscribeRequest":{"properties":{"target_url":{"type":"string","maxLength":2048,"minLength":8,"title":"Target Url"},"event_type":{"type":"string","title":"Event Type","default":"lead.created"}},"type":"object","required":["target_url"],"title":"WebhookSubscribeRequest"}},"securitySchemes":{"CrmApiKey":{"type":"apiKey","in":"header","name":"X-CRM-API-Key","description":"Ключ вида bic_crm_… из кабинета (Экспорт → API-ключ). Для проверки без аккаунта: bic_crm_sandbox_demo_key"}}},"security":[{"CrmApiKey":[]}]}