Escher V2:n julkinen API (/v1/*) vaatii Bearer-tokenin jokaiseen pyyntöön. Luo ja hallitse tokeneita API tokens -sivulla — avaa tilin valikko sivupalkin vasemmasta alakulmasta ja valitse API tokens (/settings/api-tokens).
API-käyttöoikeus on ensin otettava käyttöön
API-tokenien käyttö on rajoitettu. Sivulla voit luoda tokeneita vain, jos API-käyttöoikeus on kytketty päälle tilillesi.
Jos se ei ole käytössä, sivulla näkyy:
API access isn't enabled on your account. Contact your account manager at support@theprintspace.co.uk to request it.
Lähetä sähköpostia osoitteeseen support@theprintspace.co.uk ottaaksesi sen käyttöön, ja palaa sitten sivulle.
Ketkä tarvitsevat API-tokeneita
- Taiteilijat, jotka rakentavat mukautettuja integraalioita (esim. portfoliosivusto, joka käynnistää dropeja pyydettäessä).
- Agentuurit, jotka hallitsevat useita taiteilijatuotteita automaation kautta.
- Kehittäjät, jotka rakentavat sisäisiä työkaluja, jotka keskustelevat API:n kanssa.
Jos käytät vain verkkokäyttöliittymää ja luot dropeja manuaalisesti, et tarvitse tokenia.
Luominen
- Avaa API tokens -sivu (tilin valikko → API tokens).
- Anna Token name (kentän paikkaolevasta teksti lukee "Token name (e.g. 'Backend CI')") jotta voit tunnistaa sen myöhemmin.
- Voit halutessasi antaa Webhook URL:n — katso alla. Kentän paikkaolevasta teksti lukee "Webhook URL (optional, https://…)"; jätä se tyhjäksi tai anna täydellinen
https://-osoite. - Napsauta Generate token.
- Koko token näytetään kerran ja mukana on huomautus "Copy this token now — it will never be shown again." Kopioi se välittömästi.
- Säilytä se turvallisesti — salaisuuksien hallintapalvelussa, CI/CD-ympäristössäsi tai
.env-tiedostossa version hallinnan ulkopuolella.
Uudet tokenit näkyvät luettelossa näillä sarakkeilla: Name, Prefix, Webhook, Created, Last used. Vain etuliite tallennetaan — koko tokenia ei voi noutaa luomisen jälkeen.
Valinnainen webhook URL
Jokaiseen tokeniin voi liittää valinnaisen https://-osoitteisen webhook URL:n. Aseta se tokenia luodessasi tai muokkaa sitä myöhemmin: napsauta kynää tokenin Webhook-solun vieressä, anna täydellinen https://-osoite (tai tyhjennä se) ja tallenna.
Mitä voit tehdä tokenilla
Koko /v1-pinta on dokumentoitu OpenAPI-päätepisteessä (/openapi.json API-palvelussa). Yleiset operaatiot:
- Luo dropeja —
POST /v1/drops. - Lisää tuotteita droppeihin —
POST /v1/drops/{drop_id}/products. - Määritä variantit —
PUT /v1/drops/{drop_id}/products/{product_id}/variants. - Käynnistä julkaisu —
POST /v1/drops/{drop_id}/publish. - Tarkista julkaisun tila —
GET /v1/drops/{drop_id}/publish-attempts/latest. - Luo suosituksia —
POST /v1/recommendations. - Pura sivutyyleja URL-osoitteesta —
POST /v1/styles/extract(palauttaa viisi vaihtoehtoa valittavaksi). - Tallenna sivutyyli-esiasetukset —
POST /v1/styles.
Tunnistaminen
Välitä token Bearer-otsikkona jokaisen pyynnön kanssa:
Authorization: Bearer <your-token>
Puuttuva, peruutettu tai virheellinen token palauttaa HTTP 401:n. Jos API-käyttöoikeus on poistettu käytöstä tililtä, saat HTTP 403:n.
Nopeusrajoitukset
- Luku-päätepisteet: 120 pyyntöä minuutissa per käyttäjä.
- Kirjoitus-päätepisteet: 30 pyyntöä minuutissa per käyttäjä.
Ylittyneistä kutsuista tulee HTTP 429 ja Retry-After-otsikko. Rajoitukset ovat käyttäjäkohtaisia, eivät tokenkohtaisia, joten saman käyttäjän useita tokeneita jakavat saman paikan.
Tokenin elinkaari
- Peruuta — napsauta tokenin rivillä olevaa Revoke-painiketta ja vahvista valintaikkuna ("Revoke … This cannot be undone and the token will stop working immediately."). Tulevat pyynnöt kyseisellä tokenilla palauttavat 401:n.
- Kierrätä — luo uusi token, vaihda integraalisi käyttämään sitä, sitten peruuta vanha. Ei seisokkeja, jos teet tämän oikeassa järjestyksessä.
- Voimassaoloaika — tokenien voimassaoloaika ei ole oletuksena raja-aikaa. Kierrätä jokaisen 6–12 kuukauden välein turvallisuuden hyvän käytännön vuoksi.
Älä jaa
Tokenit ovat täydet tunnistetiedot — kuka tahansa, jolla on ne, voi toimia sinuna alustalla, mukaan lukien droppien julkaiseminen ja tuotteiden muokkaaminen. Käsittele niitä samalla tavalla kuin salasanaa.