Zolpix objavljuje višejezični katalog usluga za društvene mreže. Ova je javna integracija samo za čitanje: ne može naručivati, naplaćivati, upravljati računima ni isporučivati usluge na društvenim mrežama.
Kada koristiti Zolpix?
Koristite ga za pronalaženje objavljenih platformi i paketa usluga, usporedbu količina i osnovnih cijena te pronalaženje odgovarajuće stranice proizvoda. Parametrom locale odaberite turski (tr), engleski (en) ili hrvatski (hr). Ne pretpostavljajte da je prikazani paket dostupan za stvarnu kupnju: provjerite purchase_mode i live_purchase_available. Ne obećavajte organski rast, provjerene pratitelje, rok isporuke, povrat novca ili odobrenje platforme ako objavljeni uvjeti to ne potvrđuju.
Kako poslati zahtjev?
Autentifikacija nije potrebna. Pošaljite GET /api/v1/catalog?locale=hr sa zaglavljem Accept: application/json. Zadani je jezik en. Odgovor sadrži objavljene platforme, usluge i pakete; nacrti i privatni podaci korisnika nisu uključeni. Cijene su cijeli brojevi u manjim jedinicama valute TRY: 100 manjih jedinica iznosi 1 TRY. To su informativne kataloške cijene, a ne ponude za naplatu ili upute za plaćanje. Odabir valute na web-stranici ne mijenja API odgovor. Za aktualni postupak kupnje otvorite vraćenu adresu usluge. Prije kupnje pribavite izričito odobrenje korisnika; ovaj API ne podržava kupnju.
Ograničenja zahtjeva i pogreške
API kataloga dopušta 60 zahtjeva u minuti po IP adresi. Odgovori sadrže strukturirana zaglavlja RateLimit-Policy i RateLimit te starija zaglavlja X-RateLimit. U aktualnom nacrtu IETF HTTPAPI r označava preostalu kvotu, a t broj sekundi do obnove kvote; t nije Unix vremenska oznaka. Kod odgovora 429 pričekajte vrijeme navedeno u Retry-After prije ponovnog pokušaja. Nepodržana ili nepravilna vrijednost locale vraća JSON s HTTP statusom 422. Podržani su samo GET i HEAD. Nisu dostupni API-ji za preprodavače, MCP, narudžbe, plaćanja ni korisničke račune.
Politika verzioniranja i povlačenja iz uporabe
Trenutačni stabilni API nalazi se na /api/v1. U verziju v1 mogu se dodavati nova polja; klijenti trebaju zanemariti nepoznata polja odgovora. Nekompatibilne promjene zahtijevaju URL nove glavne verzije. Trenutačno nijedna krajnja točka nije povučena iz uporabe i nije određen datum gašenja. Ako se v1 bude ukidao, datirana obavijest bit će objavljena u ovom vodiču i u llms.txt najmanje 90 dana prije uklanjanja. Pogođene krajnje točke tada će slati standardna zaglavlja Deprecation (RFC 9745), Sunset (RFC 8594) i Link rel="deprecation". Ta se zaglavlja ne šalju prije stvarne odluke o povlačenju. Provjerite vodič prije nadogradnje klijenta.
Klijent naredbenog retka
Službeni Zolpix CLI bez dodatnih ovisnosti objavljen je na npm-u kao zolpix-cli i zahtijeva Node.js 22 ili noviji. Instalirajte ga naredbom npm install -g zolpix-cli ili pokrenite npx zolpix-cli catalog --locale hr. Paket: https://www.npmjs.com/package/zolpix-cli. Preuzmite i pregledajte https://zolpix.com/cli/zolpix.mjs. Zatim pokrenite node zolpix.mjs catalog --locale hr, node zolpix.mjs spec ili node zolpix.mjs docs --locale hr. Koristi se isti API samo za čitanje; narudžbe nije moguće slati. Katalog i shema ispisuju se kao JSON; pogreške se šalju na stderr. HTTP 429 prikazuje Retry-After i vraća izlazni kod 2. Paket na npm-u i datoteku za izravno preuzimanje održava Zolpix; oba načina koriste isti klijent samo za čitanje. Nazivi API polja i naredbe ostaju jednaki na svim jezicima.
Resursi
- Hrvatske upute za razvojne programere
- English developer guide
- Türkçe geliştirici rehberi
- Službeni npm CLI:
npm install -g zolpix-cli. - Službeni CLI: Node.js klijent naredbenog retka.
- OpenAPI 3.1 shema: Tipizirane operacije i odgovori.
- Hrvatski katalog: Objavljeni katalog samo za čitanje.
- Karta web-mjesta: Javne web-stranice.
HTTP brzi početak
curl --fail-with-body --max-time 20 -H 'Accept: application/json' 'https://zolpix.com/api/v1/catalog?locale=hr'
Polja odgovora
Uspješan odgovor sadrži locale, read_only, price_notice i platforms. Platforme sadrže services, a usluge packages. price_minor predstavlja najmanje jedinice TRY; provjerite is_sample, purchase_mode i live_purchase_available prije opisivanja dostupnosti. Potpuna shema odgovora nalazi se u OpenAPI dokumentu; HTTP 422 označava neispravan jezik, a HTTP 429 zahtijeva čekanje prema Retry-After.
