Docs

APIProdukcija

OpenAPI i alati

Specifikacija za Postman, generisanje klijenta i AI asistente.

Cijeli API je opisan u OpenAPI 3.1, iz istih šema kojima API provjerava zahtjeve: /docs/openapi.json (isto na https://api.cifra.ba/v1/openapi.json). Sadrži sve endpointe, polja, primjere, greške i webhook događaje.

Postman i Insomnia

Import → Link → zalijepite adresu specifikacije. Kolekcija ima sve endpointe s primjerima; ključ postavite kao Bearer token.

Generisanje klijenta

# TypeScript tipovi
npx openapi-typescript https://www.cifra.ba/docs/openapi.json -o cifra.d.ts

# Klijent za C#, Javu, PHP, Python… (openapi-generator)
npx @openapitools/openapi-generator-cli generate \
  -i https://www.cifra.ba/docs/openapi.json -g csharp -o ./cifra-client

AI asistenti

  • /docs/llms.txt: pregled dokumentacije s linkovima, po standardu llms.txt.
  • /docs/llms-full.txt: cijela dokumentacija kao jedan tekst — dajte je asistentu kao kontekst.
  • „Kopiraj stranicu” na svakoj stranici: Markdown za razgovor s asistentom.