# Åtkomst och behörigheter

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.