{"openapi":"3.1.0","info":{"title":"imoti-apartamenti.bg Partner API","version":"1.0.0","description":"API за синхронизация на имоти от проверени партньори."},"servers":[{"url":"https://imoti-apartamenti.bg/api/v1/partner"}],"security":[{"bearerAuth":[]}],"paths":{"/me":{"get":{"summary":"Проверка на токена и агенцията","responses":{"200":{"description":"OK"},"401":{"description":"Невалиден токен"}}}},"/listings":{"get":{"summary":"Списък на обявите на партньора","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","maximum":100}}],"responses":{"200":{"description":"OK"}}},"post":{"summary":"Създаване или обновяване по external_id","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingInput"}}}},"responses":{"200":{"description":"Обновено"},"201":{"description":"Създадено"},"422":{"description":"Грешка във валидацията"}}}},"/listings/batch":{"post":{"summary":"Пакет до 100 обяви","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["listings"],"properties":{"listings":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/ListingInput"}}}}}}},"responses":{"200":{"description":"Всички са обработени"},"207":{"description":"Частично обработване"}}}},"/listings/{externalId}":{"get":{"summary":"Една обява","parameters":[{"$ref":"#/components/parameters/externalId"}],"responses":{"200":{"description":"OK"},"404":{"description":"Не е намерена"}}},"delete":{"summary":"Архивиране на обява","parameters":[{"$ref":"#/components/parameters/externalId"}],"responses":{"200":{"description":"Архивирана"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"iap_ token"}},"parameters":{"externalId":{"name":"externalId","in":"path","required":true,"schema":{"type":"string","maxLength":190}}},"schemas":{"ListingInput":{"type":"object","required":["external_id","title","description","deal_type","property_type","location","price","area"],"properties":{"external_id":{"type":"string","example":"AG-10492"},"title":{"type":"string","maxLength":180},"description":{"type":"string","minLength":40},"deal_type":{"type":"string","enum":["sale","rent"]},"property_type":{"type":"string","enum":["apartment","house","land","office","commercial","garage"]},"location":{"type":"string","example":"София, Лозенец"},"district":{"type":"string"},"price":{"type":"number","minimum":1},"currency":{"type":"string","enum":["EUR","BGN"],"default":"EUR"},"area":{"type":"number","minimum":1},"rooms":{"type":"integer","minimum":1,"maximum":30},"floor":{"type":"integer","minimum":0},"total_floors":{"type":"integer","minimum":1},"year_built":{"type":"integer","minimum":1800},"construction_type":{"type":"string","enum":["brick","panel","epk","monolithic","prefabricated","other"]},"is_new_building":{"type":"boolean"},"images":{"type":"array","maxItems":20,"items":{"type":"string","format":"uri","pattern":"^https://"}},"video_url":{"type":"string","format":"uri"},"source_url":{"type":"string","format":"uri"},"submit_for_review":{"type":"boolean","default":true}}}}}}