{ "info": { "name": "Rentix CRM API", "description": "Colecție completă API pentru integrarea Rentix CRM.\n\nAutomatizează publicarea anunțurilor, sincronizarea agenților și gestionarea fișierelor media.\n\n**Începe:**\n- Accesează tab-ul `Variables`\n- Setează cheia API în variabila `apiKey`\n- (Opțional) Pentru a lucra cu prod, schimbă `baseUrl` la `https://crm.rentix.md/api`\n\nDocumentație: https://crm.rentix.md\n\n## Tipuri și enumerări\n\n### Anunț\n- **announcementType**: rent, sale\n- **announcementStatus**: draft, active, pending_active, publish_failed, expired, hidden, removed, completed, blocked\n- **announcementCurrency**: EUR, USD, MDL\n- **announcementBargain**: no, yes\n\n### Specifice închirierii\n- **announcementPayPeriod**: monthly, daily, hourly, yearly\n- **announcementPrepayment**: first-and-last-month, no-prepayment, months-3, months-6, custom-amount\n- **announcementRentDeposit**: months-1, months-3, custom-amount\n\n### Tipuri proprietăți\n- **propertyType**: residential, commercial, parking\n- **propertySecondaryType**:\n - rent/residential: apartment, house, room, other\n - rent/commercial: office, trade, warehouse, free-purpose, production, business, commercial-land, legal-address, other\n - rent/parking: underground-parking, open-parking, garage, covered-parking, other\n - sale/residential: apartment, house, room, residential-land, other\n - sale/commercial: office, trade, warehouse, free-purpose, production, business, commercial-land, legal-address, other\n - sale/parking: underground-parking, open-parking, garage, covered-parking, other\n\n### Câmpuri proprietate\n- **propertyQuantitySize**: apartment-studio, custom-value\n- **propertyVisualState**: classic-renovation, euro-renovation, design-renovation, requires-renovation, white-finish, rough-finish\n- **propertyHousingMarket**: secondary, new-build\n- **propertyBuildingMaterial**: brick, mixed, cotilet, monolithic, concrete, block, wood, panel, aerated-concrete\n- **propertyLayout**: 102, 135, 143, brezhnevka, varnitskaia, gostinka, custom, small-family, moldovan-series, ground-level, rubashka, stalinka, khrushchyovka, cheska\n- **propertyParkingSpace**: underground, open, garage, covered\n\n### Atribute (propertyAttributes)\n- **Reguli**: animals-allowed, can-smoke, kids-allowed, parties-allowed\n- **Facilități**: autonomous-heating, heated-floors, panoramic-windows, conditioner, tumble-dryer, dishwasher, wifi, open-plan-kitchen, balcony, terrace, work-space, kitchen, toilet, walk-in-shower, bathtub, bidet, tv, oven, pool, jacuzzi, gas, water, sewerage, video-surveillance, security, intercom, fireplace, sauna, garden, elevator, gym, playground, bbq-area, furnished", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "1.0.0" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://crm.staging.rentix.md/api", "type": "string" }, { "key": "apiKey", "value": "your-api-key-here", "type": "string" } ], "item": [ { "name": "Agenție", "description": "Obține informații despre agenție și limitele de utilizare.", "item": [ { "name": "Obține informații agenție", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/agency", "host": [ "{{baseUrl}}" ], "path": [ "v1", "agency" ] }, "description": "Returnează numele agenției, ID-ul și limitele curente de utilizare." }, "response": [] } ] }, { "name": "Anunțuri", "description": "Creare, actualizare, obținere și gestionare anunțuri imobiliare. Suportă upsert, operații în masă și legare external ID.", "item": [ { "name": "Creează sau actualizează anunț", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings" ] }, "description": "Creare/actualizare anunț. Dacă externalId este nou — creează, dacă există — actualizează. Trimite doar câmpurile modificate.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001\",\n \"announcementStatus\": \"active\",\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\",\n \"announcementPayPeriod\": \"monthly\",\n \"propertyArea\": 65,\n \"propertyFloorNumber\": 3,\n \"propertyFloorsTotal\": 9,\n \"propertyQuantitySize\": \"custom-value\",\n \"propertyQuantitySizeValue\": 3,\n \"propertyHousingMarket\": \"new-build\",\n \"propertyVisualState\": \"euro-renovation\",\n \"propertyAddress\": \"Chișinău, str. Columna 81/1\",\n \"announcementDescription\": \"Apartament confortabil cu 3 camere cu podele calde și încălzire autonomă.\",\n \"files\": [\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Living\",\n \"externalFileId\": \"apt-001-photo-1\"\n },\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Dormitor\",\n \"externalFileId\": \"apt-001-photo-2\"\n },\n {\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Bucătărie\",\n \"externalFileId\": \"apt-001-photo-3\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Validare anunț", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/validate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "validate" ] }, "description": "Validare date anunț fără a crea. Util pentru validarea formularelor din CRM.", "body": { "mode": "raw", "raw": "{\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\",\n \"announcementDescription\": \"Apartament confortabil cu 3 camere cu podele calde și încălzire autonomă.\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Operații în masă", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "bulk" ] }, "description": "Procesare până la 100 operații cu anunțuri într-o singură cerere. Suportă upsert, link, unlink, delete și validate.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upsert\",\n \"externalId\": \"apt-001\",\n \"announcementType\": \"rent\",\n \"propertyType\": \"residential\",\n \"propertySecondaryType\": \"apartment\",\n \"announcementValue\": 500,\n \"announcementCurrency\": \"EUR\"\n },\n {\n \"op\": \"link\",\n \"id\": 42,\n \"externalId\": \"apt-001\"\n },\n {\n \"op\": \"delete\",\n \"externalId\": \"apt-002\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Listă anunțuri", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings" ], "query": [ { "key": "status", "value": "active", "description": "Filtrare după status (draft, active, hidden, completed, pending_active)", "disabled": true }, { "key": "userId", "value": "1", "description": "Filtrare după ID utilizator Rentix", "disabled": true }, { "key": "externalUserId", "value": "agent-001", "description": "Filtrare după external ID utilizator", "disabled": true }, { "key": "syncedAfter", "value": "2025-01-01T00:00:00Z", "description": "Doar anunțuri sincronizate după această dată", "disabled": true }, { "key": "page", "value": "1", "description": "Numărul paginii (implicit 1)", "disabled": true }, { "key": "limit", "value": "20", "description": "Elemente pe pagină, max 100 (implicit 20)", "disabled": true } ] }, "description": "Obține o listă paginată de anunțuri cu filtre opționale." }, "response": [] }, { "name": "Obține anunț după ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id" ] }, "description": "Obține un anunț după ID-ul intern Rentix." }, "response": [] }, { "name": "Obține anunț după External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", "external", ":externalId" ] }, "description": "Obține un anunț după external ID-ul tău din CRM." }, "response": [] }, { "name": "Leagă External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id", "link" ] }, "description": "Leagă un external ID din CRM la un anunț Rentix existent.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Dezleagă External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/listings/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "listings", ":id", "link" ] }, "description": "Elimină legătura external ID de la un anunț." }, "response": [] } ] }, { "name": "Utilizatori", "description": "Creare, actualizare și gestionare profiluri agenți. Suportă upsert și legare external ID.", "item": [ { "name": "Creează sau actualizează utilizator", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users" ] }, "description": "Creare/actualizare profil agent. Identificare prin externalId sau id.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"agent-001\",\n \"name\": \"Ion Popescu\",\n \"description\": \"Agent imobiliar experimentat. Lucrez cu proprietăți rezidențiale și comerciale.\",\n \"instagram\": \"https://instagram.com/ion.popescu\",\n \"settings\": {\n \"contact_phone\": true,\n \"contact_whatsapp\": true,\n \"contact_telegram\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Operații în masă", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", "bulk" ] }, "description": "Procesare până la 100 operații cu utilizatori într-o singură cerere.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upsert\",\n \"externalId\": \"agent-001\",\n \"name\": \"Ion Popescu\",\n \"settings\": {\n \"contact_whatsapp\": true\n }\n },\n {\n \"op\": \"upsert\",\n \"externalId\": \"agent-002\",\n \"name\": \"Maria Ionescu\",\n \"settings\": {\n \"contact_telegram\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Listă utilizatori", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users" ] }, "description": "Listează toți agenții din agenția ta." }, "response": [] }, { "name": "Obține utilizator după ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id" ] }, "description": "Obține un agent după ID-ul intern Rentix." }, "response": [] }, { "name": "Obține utilizator după External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", "external", ":externalId" ] }, "description": "Obține un agent după external ID-ul tău din CRM." }, "response": [] }, { "name": "Leagă External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id", "link" ] }, "description": "Leagă un external ID din CRM la un utilizator Rentix existent.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"agent-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Dezleagă External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/users/:id/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "users", ":id", "link" ] }, "description": "Elimină legătura external ID de la un utilizator." }, "response": [] } ] }, { "name": "Media", "description": "Încărcare, gestionare și legare fișiere media. Suportă import URL, URL-uri semnate și operații în masă.", "item": [ { "name": "Solicită URL de încărcare", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/request-upload-url", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "request-upload-url" ] }, "description": "Obține URL-uri semnate pentru încărcare directă. URL-urile sunt valide 30 de minute.", "body": { "mode": "raw", "raw": "{\n \"files\": [\n {\n \"fileName\": \"living-room.jpg\",\n \"size\": 245000,\n \"contentType\": \"image/jpeg\",\n \"externalId\": \"apt-001-photo-1\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Confirmă încărcarea", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/confirm-upload", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "confirm-upload" ] }, "description": "Confirmă că fișierul a fost încărcat la URL-ul semnat.", "body": { "mode": "raw", "raw": "{\n \"generatedFileName\": \"abc123_living-room.jpg\",\n \"uuid\": \"abc123\",\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Încarcă de la URL", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/upload-from-url", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "upload-from-url" ] }, "description": "Importă un fișier media de la un URL public. Sistemul descarcă și optimizează automat.", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Living\",\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Operații în masă", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "bulk" ] }, "description": "Procesare până la 100 operații media. Suportă upload-from-url, confirm-upload, link, unlink și delete.", "body": { "mode": "raw", "raw": "{\n \"operations\": [\n {\n \"op\": \"upload-from-url\",\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Living\",\n \"externalId\": \"apt-001-photo-1\"\n },\n {\n \"op\": \"upload-from-url\",\n \"url\": \"https://placehold.co/1920x1080/jpg?text=Dormitor\",\n \"externalId\": \"apt-001-photo-2\"\n },\n {\n \"op\": \"link\",\n \"mediaId\": 123,\n \"externalId\": \"old-photo-linked\"\n },\n {\n \"op\": \"delete\",\n \"externalId\": \"old-photo-to-remove\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Obține media", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId" ] }, "description": "Obține un fișier media după ID-ul intern Rentix." }, "response": [] }, { "name": "Obține media după External ID", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "external", ":externalId" ] }, "description": "Obține un fișier media după external ID-ul tău din CRM." }, "response": [] }, { "name": "Șterge media", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId" ] }, "description": "Șterge un fișier media după ID-ul intern Rentix." }, "response": [] }, { "name": "Șterge media după External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/external/:externalId", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", "external", ":externalId" ] }, "description": "Șterge un fișier media după external ID-ul tău din CRM." }, "response": [] }, { "name": "Leagă External ID", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId", "link" ] }, "description": "Leagă un external ID din CRM la un fișier media existent.", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"apt-001-photo-1\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Dezleagă External ID", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/media/:mediaId/link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "media", ":mediaId", "link" ] }, "description": "Elimină legătura external ID de la un fișier media." }, "response": [] } ] }, { "name": "Referințe", "description": "Acces la date de referință: scheme câmpuri, locații și valute.", "item": [ { "name": "Obține schema de bază", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/schema/base", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "schema", "base" ] }, "description": "Obține schema de bază a câmpurilor. Returnează tipuri de anunțuri, categorii de proprietăți, câmpuri formular și restricții." }, "response": [] }, { "name": "Obține schema contextuală", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/schema", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "schema" ], "query": [ { "key": "announcementType", "value": "rent", "description": "rent sau sale" }, { "key": "propertyType", "value": "residential", "description": "residential, commercial sau parking" }, { "key": "propertySecondaryType", "value": "apartment", "description": "Subtipul specific al proprietății" } ] }, "description": "Obține schema contextuală a câmpurilor pentru o combinație specifică de tip proprietate. Toți cei 3 parametri sunt obligatorii." }, "response": [] }, { "name": "Obține valute", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/reference/currencies", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reference", "currencies" ] }, "description": "Obține valutele suportate și cursurile de schimb actuale." }, "response": [] } ] }, { "name": "Job-uri", "description": "Urmărirea statusului job-urilor asincrone (procesare foto, publicare etc.).", "item": [ { "name": "Obține status job", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/job/status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "job", "status" ], "query": [ { "key": "id", "value": "789", "description": "ID-ul job-ului returnat din operațiile cu anunțuri/media" } ] }, "description": "Verifică statusul unui job asincron după ID-ul său." }, "response": [] } ] } ] }