Åtkomst och behörigheter
På den här sidan
Skapa, avgränsa, rotera och återkalla företagets integrationsnycklar.
Företagsåtkomst
En administratör för ett befintligt, verifierat Homito-företag skapar en nyckel under Settings → API & agents. Detta kräver administratörens Homito-användarsession och behörigheten settings.edit. Hemligheten visas en gång: lägg den i serverns hemlighetshanterare. Nyckeln bestämmer företaget; ett annat företags-ID i anropet utökar inte åtkomsten. Extern självregistrering av företag är inte tillgänglig. Nyckelhantering använder Homito-webbappens adress och dess användarsession, inte den här externa API-adressen.
Välj uppgift och behörigheter
| Uppgift | Nyckelbehörigheter | Börja här |
|---|---|---|
| Läs fastigheter och lägenheter | read:properties | GET /api/v1/landlord/inventory/properties |
| Läs publicerade och opublicerade annonser; synkronisera annonser | read:properties; write:properties för motsvarande ändring | GET /api/v1/landlord/listings, GET /api/v1/landlord/listings/changes, PATCH /api/v1/landlord/listings/{unitId}/content, POST /api/v1/landlord/listings/{unitId}/media/uploads, POST /api/v1/landlord/listings/{unitId}/media/uploads/{uploadId}/complete, PATCH /api/v1/landlord/listings/{unitId}/media, PATCH /api/v1/landlord/listings/{unitId}/publication |
| Läs hyresgästernas kontaktuppgifter | read:tenants | GET /api/v1/landlord/tenants |
| Läs hyresavtalens tidslinjer | read:leases | GET /api/v1/landlord/leases |
| Läs sammanfattningar av ansökningar | read:applications | GET /api/v1/landlord/applications |
| Förhandsgranska och spara fastigheter och lägenheter | write:properties; read:properties för återläsning | POST /api/v1/landlord/portfolio-imports/preview |
| Läs eller importera kommersiella hyreslistor | read:rent-roll; write:rent-roll för import | GET /api/v1/landlord/rent-roll |
| Läs eller uppdatera driftärenden | read:fault-reports, read:work-orders; write:fault-reports, write:work-orders för motsvarande ändring | GET /api/v1/landlord/fault-reports, GET /api/v1/landlord/work-orders |
| Läs eller genomför kommersiella besiktningar | read:inspections; write:inspections för ändringar | GET /api/v1/landlord/commercial-inspections |
| Läs eller använd assistans för kommersiella hyresgäster | read:commercial-assistance; write:commercial-assistance för ändringar | GET /api/v1/landlord/commercial-assistance |
| Starta en screening och läs certifierad status | write:screenings, read:screenings; read:applications för att välja en kandidat | POST /api/v1/landlord/screenings |
| Registrera webhooks och följ leveranser | write:webhooks, read:webhooks | POST /api/v1/landlord/webhooks |
| Använd kundserverns ansökningsbudget eller den värdbaserade eID-överlämningen | write:applications på en separat servernyckel | POST /api/v1/public/units/{slug}/application-eid/handoffs |
Förstå gränserna för mänskliga beslut och portalen
| Åtgärd | Tillgänglig väg | Gräns för människa/portal |
|---|---|---|
| Första företagsåtkomst; skapa, rotera eller återkalla en nyckel | Autentiserat administratörskontrollplan | Befintligt verifierat företag, användarsession och settings.edit krävs |
| Vanliga auktoriserade läsningar och skrivningar som stöds | Externt REST-API; MCP-verktyg som stöds efter verifierad distribution | Ingen dashboard-interaktion krävs för varje vanlig operation |
| Ändra annonsnamn och lägenhetstext | PATCH för annonsinnehåll; MCP-verktyg som stöds efter verifierad distribution | Kräver aktuell write:properties; media och publicering kräver sin separata uttryckliga annonsfullmakt |
| Screeningkörning, Detective och operativ ärendehantering | Separat StaySafe-tjänst | Homitos integration returnerar endast den tillåtna certifierade hyresvärdsprojektionen |
| Beslut om sökande och granskning av besiktningar | Deras uttryckligt auktoriserade besluts-/granskningsoperationer | En nyckel eller agentinstruktion ersätter inte mänsklig befogenhet eller ansvarsfördelning |
Rotera och avveckla nycklar
Vid rotation skapar du en ersättningsnyckel med samma eller snävare behörigheter, tar den i bruk i integrationen och verifierar en autentiserad läsning. Före återkallning av den gamla nyckeln slutför eller stämmer du av dess utestående förhandsgranskningar och jobb med den gamla nyckeln. En ersättningsnyckel ärver inte deras jobb-ID:n eller historik. Återkalla sedan den gamla nyckeln. Administratören använder Settings → API & agents eller dess autentiserade kontrollplan /api/v1/settings/api-keys. En företagsintegrationsnyckel är inte en administratörssession. Nyckel-ID:n är icke-hemliga referenser, inte autentiseringsuppgifter; den råa nyckeln kan inte hämtas senare. Verifiera att den avvecklade nyckeln avvisas.
Håll privata uppgifter utanför offentliga cacheminnen
Håll personuppgifter, kvitton och uppladdningsåtkomsträtter utanför offentliga annonscacheminnen. Hyresgäst- och ansökningsläsningar returnerar avsiktligt begränsade operativa projektioner; dra inga slutsatser om utelämnade privata fält eller screeningbedömningar. Skilj null/okända värden från noll eller ett slutfört resultat.
Använd den publicerade kontraktsversionen
Använd API-versionen och livscykeln i API-referensen, varje operations scheman samt eventuell nödvändig formulär- eller resursversion när en integration uppdateras. Bevara opaka versioner oförändrade och lås en godkänd MCP-release. Händelsenamn kommer från samma katalog som API:t; ankomstordning och en produktversion ersätter inte aktuell återläsning av resursen.