Skok na sadržaj
Pitanja?PaperOffice AI Phone Agent 24/7+49 69 3487102-0
Pregled Pregled Vesti Vesti
Podeli

Publishable Keys

Browser-sigurni API pozivi. Bez sopstvenog backend-a.

Publishable Key (po_pk_) može biti u frontendu: ograničen opseg, vezan za poreklo i limitiran budžet.

Za Claude artefakte, ChatGPT Canvas, Grok i svaku sopstvenu web aplikaciju.

Sopstveni prefiks po_pk_ Podrazumevano vezano za Origin Opoziv u svakom trenutku
Browser-sigurni API pozivi. Bez sopstvenog backend-a.

Direktno iz pregledača

Od AI-Canvas direktno do poziva API

Gradite PDF-u-tekst aplikaciju u Claude artefaktima, ChatGPT Canvas ili Grok. Bez bekenda, poziv API je ostao izostavljen: CORS blokira, tajni ključ bi bio vidljiv u izvornom kodu, a otvoreni ključ opterećuje vaš nalog. Upravo ovu prazninu popunjuju Publishable Keys.

Radi u Claude ArtifactsChatGPT CanvasGrokSvaka browser aplikacija

Umetnuti u Claude, ChatGPT ili Grok

Prompt koji svaku AI-Canvas pretvara u pravu demo verziju podržanu od API — bez bekenda.

AI-Kanvas Prompt
Pročitajte ovaj API dokument:
https://api.paperoffice.ai/latest/docs/llms-full.txt Izradite aplikaciju u jednom fajlu (Claude Artifact / ChatGPT Canvas / Grok):
Korisnik otprema PDF, aplikacija poziva
/job/add/paperoffice_aiocr___generate direktno iz pregledača
i prikazuje ekstrahovani tekst. Autentifikacija: Bearer po_pk_MY_PUBLISHABLE_KEY (tražite ključ od korisnika).
Koristite processing_lane=instant za sinhronizovane rezultate. Zaglavlje Origin postavlja pregledač.

Izbor preseta, kreiranje ključa, lepljenje.

Dashboard pruža presete za opsege i budžet. Poreklo ostaje prazno — unesite zaglavlje Origin iz browser DevTools, zatim kopirajte ključ u svoj prompt.

Kreiranje ključa
JavaScript
const form = new FormData();form.append("file_1", fileInput.files[0]);form.append("processing_lane", "instant");form.append("client_wait", "true");const response = await fetch("https://api.paperoffice.ai/latest/job/add/paperoffice_aiocr___generate", {  method: "POST",  headers: { Authorization: "Bearer po_pk_YOUR_PUBLISHABLE_KEY" },  body: form,});console.log(await response.json());

Prvi poziv

fetch iz pregledača, Origin postavlja pregledač

Poziv ide na POST /latest/job/add/{pipeline} — isti endpoint kao sa tajnim ključem. Novo su samo vrsta ključa i Origin zaglavlje koje browser automatski šalje.

  • Origin dolazi od browsera

    fetch automatski postavlja Origin zaglavlje. Skripte van browsera (cURL, Node) moraju ga eksplicitno poslati — u suprotnom API odgovara sa 403 ORIGIN_HEADER_REQUIRED.

  • Rezultat inline

    Sa processing_lane=instant i client_wait=true, API zadržava vezu i vraća rezultat direktno u odgovoru.

  • Jasni kodovi grešaka

    402 BUDGET_EXHAUSTED, 403 DOMAIN_NOT_ALLOWED, 403 SCOPE_NOT_GRANTED, 429 RATE_LIMIT_EXCEEDED — svaka granica se javlja sa svojim kodom.

Matrica bezbednosti

Šest kontrola, sve server-side prisilno izvršene

Ograničen opseg, vezan za poreklo, limitiran budžet, povlačenje u svakom trenutku. Svaka kontrola se nameće na serveru — zato ključ može biti u frontend kodu.

  • Ograničen opseg

    Ključevi dostižu samo grupe endpointa koje eksplicitno odobravate: ocr:read, llm:generate, translate:text i druge. Pozivi van opsega vraćaju HTTP 403.

  • Vezano za poreklo

    Svaki zahtev mora sadržati Origin zaglavlje koje odgovara allow-listi ključa (tačan host ili wildcard poddomene). Ako ne odgovara, vraća se HTTP 403 sa kodom API.

  • Bez dodatnog limita minuta

    Ne postoji poseban limit minuta samo za po_pk_. Važe normalni token rate limiti naloga; potrošnju ograničava budžet životnog veka.

  • Budget ograničen

    Svaki ključ ima budžet životnog veka. Kada se potroši, API vraća HTTP 402 BUDGET_EXHAUSTED — potrošnja se zaustavlja odmah, a ne tek pri obračunu.

  • Opoziv u bilo kom trenutku

    Ključevi se mogu opozvati u bilo kom trenutku kroz nalog. Opozvani ključ više neće biti prihvaćen od strane API.

  • Trajno zaključano

    HTTP DELETE kao i prijava na nalog, upravljanje ključevima, OAuth, partner admin, plaćanje i lomljenje lozinke ostaju trajno blokirani za svaki po_pk_. Dokumentovani produkt-API su dozvoljeni, uključujući brisanje putem POST-a, webhooks, čitanje fakturisanja i CRM.

Hijerarhija ključeva

Tri vrste ključeva, jasne odgovornosti

Secret Key za server, Publishable Key za browser — plus korisnički token za pristup vezan za korisnika sa ograničenjem brzine.

Prefiks Tip Upotreba Pretraživač siguran Podrazumevani opseg
poai_ API ključ Server-na-server, prava naloga koji ga kreira Ne Svi endpointi u okviru plana i dozvola
po_ut_ User Token Korisnički opseg, ograničen na nivo Ne Na osnovu nivoa
po_pk_ Publishable Key Pretraživač / AI-Canvas (Claude, ChatGPT, Grok) Da Lista opsega

Autentifikacija i ključevi

Tri unapred definisana podešavanja

Jedan klik. Jedan ključ. Jedna svrha.

Svaki preset je podešen za konkretan slučaj upotrebe — sigurne podrazumevane vrednosti, kurirani opsezi, realistični budžeti. Sve se može prilagoditi u bilo kom trenutku na kontrolnoj tabli.

  • DEFAULT Sigurno čitanje

    Sigurna podrazumevana prava za jednostavne demonstracije i interne alate: OCR, LLM, Prevod, Dokumenti, Pretraga.

    Opsezi dozvola

    ocr:readllm:generatetranslate:textdocuments:uploaddocuments:readsearch:query
    Početak sa ovim presetom
  • WIDGET Javni web sajt

    Za kontakt forme, chat widgete i dugmad za rezervacije na sopstvenom poslovnom sajtu.

    Opsezi dozvola

    knowledge:readwidget:chatwidget:bookingwidget:formswidget:contactwidget:leadwidget:fingerprint
    Početak sa ovim presetom

Prvi API poziv

Spremni za prvi poziv iz pregledača?

Kreirajte ključ, otvorite llms-full.txt, umetnite prompt — vaša aplikacija direktno poziva API iz Claude, ChatGPT ili Grok-a.

Vlastivi prefiks Bez backend-a Poništivo u svakom trenutku

Česta pitanja

Sve bitno na jednom mestu

Kako se po_pk_ razlikuje od poai_?

poai_ (API ključ) služi za integraciju server-na-server — radi sa pravima naloga koji ga kreira i nikada se ne sme koristiti u pregledniku. po_pk_ (Publishable Key) je namenjen kodu u pregledniku: ograničenog opsega, zaključan na poreklo, sa ograničenim budžetom. Isti API, različiti profil bezbednosti.

Zašto jednostavno ne koristiti reverse-proxy iz sopstvenog backend-a?

To je klasičan put — ali i dalje zahteva backend. AI-artefakti (Claude, ChatGPT, Grok) su dizajnirani za rad bez sopstvenog backend-a. Publishable Keys to omogućavaju, a da pritom ne otkrijete svoj Secret Key: granice se nameću na serveru.

Da li ovo funkcioniše u Claude artefaktima, uprkos njihovoj CORS sandbox?

Da. Poziv se izvršava direktno iz pregledača, a zaglavlje Origin postavlja sam pregledač. PaperOffice ne isporučuje vendor allow listu; poreklo unosite pri kreiranju ključa iz DevTools.

Šta se dešava ako moj po_pk_ postane javno vidljiv?

Šteta je ograničena: Origin Lock blokira korišćenje na stranim domenima, Budget Limit prekida potrošnju, Rate Limit usporava automatske pristupe. Opozovite ključ u nalogu — nakon toga ga API više ne prihvata.

Mogu li dodati svoju sopstvenu domenu kao dozvoljeni origin?

Da. Prilikom kreiranja ključa dodajete svaki origin na Allow listu — kao tačan host ili wildcard za poddomene. WIDGET preset je baš za to dizajniran: registrujte svoju domenu i ugradite Chat, Booking ili Kontakt widgete bez backend-a.

Kako postaviti budžet po ključu?

Pri kreiranju birate Lifetime limit; presetovi imaju svoje podrazumevane vrednosti. Kada se limit iscrpi, API vraća HTTP 402 BUDGET_EXHAUSTED. Vrednost možete u bilo kom trenutku prilagoditi u svom nalogu.

Da li po_pk_ zahteva sopstveni tarifni plan?

Ne. Publishable Key je dodatni sloj zaštite oko vašeg postojećeg naloga: ograničava opsege, porekla i budžet. Koja opcija odgovara vašem podešavanju prikazuje pregled cena.

Koji endpointi su blokirani za po_pk_?

HTTP DELETE kao i prijava na nalog, korisnički admin, upravljanje ključevima, OAuth, partner admin, Stripe checkout i lomljenje lozinke su trajno blokirani. Dokumentovani produkt-API su dozvoljeni, uključujući brisanje putem POST-a, webhooks, čitanje fakturisanja, import i CRM. Brisanje Workspace, pražnjenje korpe i oslobađanje legalnog zadržavanja ostaju samo u interfejsu (403 UI_ONLY_ENDPOINT).

PaperOffice AI · Problem Solver

Ispričajte nam, šta vam svakodnevno oduzima vreme.

Jednostavno opišite. Nisu potrebni stručni termini.

Ili započnite sa primerom

Kako želite da koristite PaperOffice?

Računar i pametni telefon su povezani: radni prostor na računaru, prikupljanje na telefonu.

Gde želite da počnete?

Puna verzija radnog prostora optimizovana je za računare. Mobilna verzija je pogodna za prikupljanje, proveru i odobravanje dokumenata.

Registrovati se besplatno app.paperoffice.ai

Započnite na računaru

Poslaćemo vaš lični link za pristup na vašu e-mail adresu.

Otvorite PaperOffice Mobile

Prikupljajte i obrađujte dokumente direktno putem pametnog telefona.

Otvori mobilnu verziju