> ## 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.

# Vocabularul

> Tipurile, subtipurile, câmpurile cu tipul și unitatea lor, dotările și codurile retrase. Public, fără cheie; etichetele urmează `locale`, codurile nu se traduc niciodată.



## OpenAPI

````yaml ro/openapi.json GET /schema
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 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
paths:
  /schema:
    get:
      tags:
        - Vocabular
      summary: Vocabularul
      description: >-
        Tipurile, subtipurile, câmpurile cu tipul și unitatea lor, dotările și
        codurile retrase. Public, fără cheie; etichetele urmează `locale`,
        codurile nu se traduc niciodată.
      operationId: v1.schema
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vocabulary'
          description: Reușit.
      security: []
components:
  schemas:
    Vocabulary:
      type: object
      title: Vocabulary
      properties:
        locale:
          type: string
          description: Limba etichetelor din răspuns.
        version:
          type: string
          description: >-
            Versiunea formei vocabularului. Crește doar la o schimbare
            incompatibilă a formei; codurile noi apar fără să o schimbe.
        types:
          type: array
          items:
            type: object
          description: >-
            Tipurile de proprietate, cu tranzacțiile permise și subtipurile
            fiecăruia.
        transactions:
          type: array
          items:
            type: object
          description: >-
            Tranzacțiile, cu `price_period` (ce cumpără prețul) și `available`
            (dacă tranzacția e deschisă acum pe platformă).
        currencies:
          type: array
          items:
            type: object
          description: Monedele acceptate în `price_currency`.
        fields:
          type: object
          description: >-
            Fiecare câmp al anunțului: tipul valorii, unitatea, tipurile de
            proprietate și tranzacțiile la care există, valorile permise.
        field_types:
          type: array
          items:
            type: object
          description: Tipurile de valori folosite în `fields`.
        units:
          type: array
          items:
            type: object
          description: Unitățile folosite în `fields`.
        features:
          type: array
          items:
            type: object
          description: >-
            Catalogul de dotări, cu grupul și tipurile de proprietate la care se
            aplică fiecare.
        levels:
          type: object
          description: >-
            Codurile de nivel, pentru `floor` și pentru eticheta `floor` a
            pozelor.
        street_types:
          type: array
          items:
            type: object
          description: Tipurile de stradă (stradă, bulevard, șosea…), ca prefix al adresei.
        photo_rooms:
          type: array
          items:
            type: object
          description: Codurile de încăperi pentru etichetele pozelor.
        retired:
          type: array
          items:
            type: object
          description: Codurile retrase și succesorii lor.
      required:
        - locale
        - version
        - types
        - transactions
        - currencies
        - fields
        - field_types
        - units
        - features
        - levels
        - street_types
        - photo_rooms
        - retired
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer <key>'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.