> ## Documentation Index > Fetch the complete documentation index at: https://api.housera.ro/llms.txt > Use this file to discover all available pages before exploring further. # Cheia cu care faci cererea > Ce știe Housera despre cheia din cerere: numele, drepturile, când a fost creată și când expiră, firma de care e legată și rolul contului în firmă. De rol depinde ce vede cheia (vezi Ce anunțuri vede fiecare cheie), așa că îl poți citi înainte de primul apel. Pentru o legătură cu un integrator primești și `connection_id` și numele aplicației. Merge cu orice cheie valabilă, fără un drept anume. Emailul și telefonul contului nu apar aici. ## OpenAPI ````yaml ro/openapi.json GET /account/key openapi: 3.1.2 info: title: Housera API version: 1.0.0 description: >- Publică și gestionează anunțuri imobiliare pe Housera din CRM-ul sau din aplicația ta, cu aceleași reguli ca formularul din portalul Housera. servers: - url: https://staging.housera.ro/api/v1 description: 'Sandbox (staging): date de test, aceleași reguli ca producția.' - url: https://housera.ro/api/v1 description: 'Producție: anunțurile reale de pe housera.ro.' security: - bearer: [] tags: - name: Anunțurile tale - name: Poze - name: Evenimente - name: Vocabular - name: Conectează cu Housera - name: Cererile clienților - name: Firma și echipa - name: Mandatele de comercializare - name: Vizionări - name: Proiecte - name: Parteneriate - name: Cheia API - name: Statistici paths: /account/key: get: tags: - Cheia API summary: Cheia cu care faci cererea description: >- Ce știe Housera despre cheia din cerere: numele, drepturile, când a fost creată și când expiră, firma de care e legată și rolul contului în firmă. De rol depinde ce vede cheia (vezi Ce anunțuri vede fiecare cheie), așa că îl poți citi înainte de primul apel. Pentru o legătură cu un integrator primești și `connection_id` și numele aplicației. Merge cu orice cheie valabilă, fără un drept anume. Emailul și telefonul contului nu apar aici. operationId: v1.account.key parameters: - name: locale in: query required: false schema: type: string enum: - ro - en default: ro example: ro description: >- Limba răspunsului, `ro` sau `en`. Schimbă mesajele erorilor (`title`, `detail`), etichetele și, când anunțul are o traducere aprobată în limba cerută, titlul și descrierea lui. Codurile sunt aceleași în orice limbă. Are întâietate față de `Accept-Language` și de limba contului. responses: '200': content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/ApiKeyApiResource' description: Rezultatul cererii. required: - data description: Cererea a reușit. '401': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: Cheia lipsește, e revocată sau a expirat (`unauthenticated`). '403': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- Cheia nu are dreptul cerut (`missing_ability`) sau accesul e refuzat (`forbidden`). '429': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- Prea multe cereri. Reîncearcă după numărul de secunde din `Retry-After`. components: schemas: ApiKeyApiResource: type: object properties: name: type: string description: Numele cheii, ales la creare. La o legătură, numele aplicației. abilities: type: array items: {} description: Drepturile cheii, de exemplu `listings:read` (vezi Autentificare). created_at: type: - string - 'null' description: Când a fost creată cheia. expires_at: type: - string - 'null' description: Când expiră cheia. După această dată, cererile cu ea primesc `401`. connection_id: type: - integer - 'null' description: >- Pentru o legătură cu un integrator, id-ul legăturii: același `connection_id` ca la schimbul de cod și același cu câmpul `connection` din livrările webhook-ului. `null` pentru o cheie creată de cont în Setări → API. client: type: - object - 'null' properties: name: type: string description: Numele aplicației. required: - name description: >- Aplicația integratorului, pentru o legătură. `null` pentru o cheie creată de cont. account: type: object properties: name: type: string description: Numele contului. required: - name description: Contul în numele căruia lucrează cheia. firm: type: - object - 'null' properties: name: type: string description: Numele firmei. kind: type: string enum: - agency - developer description: '`agency` (o agenție) sau `developer` (un dezvoltator).' required: - name - kind description: >- Firma de care e legată cheia: cea în care a fost creată sau pentru care s-a dat acordul. Rămâne aceeași și dacă omul trece în altă firmă. `null` pentru o cheie fără firmă. role: type: - string - 'null' description: >- Rolul contului în firma cheii: `owner`, `admin`, `manager` sau `agent`. Titularul și administratorii văd toată firma, managerul punctul lui de lucru, agentul ce e al lui. `null` pentru o cheie fără firmă. required: - name - abilities - created_at - expires_at - connection_id - client - account - firm - role title: ApiKeyApiResource Problem: type: object title: Problem properties: type: type: string format: uri description: Adresa tipului de problemă (RFC 9457). title: type: string description: Rezumatul problemei, în limba cererii. status: type: integer description: Codul HTTP. code: type: string description: >- Codul stabil al refuzului, după care tratezi eroarea (lista e în pagina Erori). detail: type: string description: Explicația, în limba cererii. existing: type: object properties: code: type: string description: Codul public al anunțului existent. external_ref: type: - string - 'null' description: >- Id-ul tău pentru anunțul existent, dacă l-ai pus tu cu `PUT /listings/ref/{ref}`. Altfel `null`. required: - code - external_ref description: >- Doar la `409 duplicate_listing`: anunțul pe care îl ai deja pentru aceeași proprietate. required: - type - title - status - code - detail securitySchemes: bearer: type: http scheme: bearer description: 'Authorization: Bearer ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.