API i CLI

API ključevi

Sav programski pristup Ownlate koristi API ključeve. Idite na Radni prostor → API ključevi da kreirate ključ.

Svaki ključ ima:

• Naziv — oznaka za identifikaciju ključa (npr. ci-pipeline)
• Dozvole — detaljna prava (isti skup kao dozvole člana radnog prostora)
• Rok trajanja — opcioni datum isteka; ključ prestaje da radi nakon ovog datuma

REST API

Sve API reference i dostupne endpointe možete pronaći u interaktivnoj dokumentaciji:

API dokumentacija (Swagger)

Prosledite API ključ u zaglavlju Authorization:

Authorization: Bearer <vaš-api-ključ>

Javni endpointi (bez autorizacije)

Projekti označeni kao javni izlažu endpointe samo za čitanje bez autorizacije:

GET /public/projects/:projectId/translations-map?lang=sr

Vraća mapu ključ → vrednost odobrenih prevoda za dati jezik.

CLI

Alat @ownlate/cli je dizajniran za CI/CD pipeline. Instalirajte ga:

npm install -g @ownlate/cli
# ili
pnpm add -g @ownlate/cli

Autorizacija

ownlate login --api-key <vaš-api-ključ>

Ili postavite promenljivu okruženja:

export OWNLATE_API_KEY=<vaš-api-ključ>

Slanje izvornih fajlova

ownlate push --project <project-id> --file ./locales/en.json --lang en

Preuzimanje odobrenih prevoda

ownlate pull --project <project-id> --lang sr --output ./locales/sr.json

Preuzeti sve jezike odjednom:

ownlate pull --project <project-id> --output ./locales/

Primer CI/CD

- name: Poslati stringove u Ownlate
  run: ownlate push --project $PROJECT_ID --file locales/en.json --lang en
  env:
    OWNLATE_API_KEY: ${{ secrets.OWNLATE_API_KEY }}

- name: Preuzeti odobrene prevode
  run: ownlate pull --project $PROJECT_ID --output locales/
  env:
    OWNLATE_API_KEY: ${{ secrets.OWNLATE_API_KEY }}