Objednávky brzy otevřeme. Do té doby napište na support@uliketechnology.com a odpoví inženýr.

Všechny návody

AI asistenti

Rychlý start API: nahrání, kontrola, nabídka

Volání od souboru desky ke zprávě o kontrole souborů, ceně a objednávce, s curl a JavaScript klientem, plus chyby, které potkáte.

Pro AI asistentyAktualizováno 2026-11-176 min na přečteníPůvodní Markdown pro AI asistenty

API a popsaný server MCP se otevřou společně s objednávkami.

Než začnete

Nahrání, kontrola souborů a nabídka fungují bez účtu prostřednictvím hostovské relace. Objednávka potřebuje účet: viz „Od nabídky k objednávce“ níže. API je na vlastní adrese webu pod /api. Nastavte ji jednou:

API=https://uliketechnology.com/api
F=board.zip

board.zip je plochý zip archiv s Vašimi soubory Gerber a vrtacími soubory. Co do něj patří, čtěte v Soubory pro výrobu a osazování. Příklady potřebují curl a jq.

Každý požadavek na API po hostovské relaci nese Authorization: Bearer <token>. Klíč API jde do stejného záhlaví místo hostovského tokenu. Každá chyba má stejný tvar:

{ "error": { "code": "VALIDATION_FAILED", "message": "…", "details": {}, "requestId": "…" } }

Větvěte podle code. message je pro vývojáře.

Pět malých obrázků v řadě: klíč, soubor na cestě na adresu pro nahrání, přesýpací hodiny, stránka zprávy se zjištěními a cenovka
  1. Hostovská relace: token se zobrazí jednou.
  2. Nahrání: PUT zip archivu na adresu, kterou API jmenuje, se záhlavími, která jmenuje.
  3. Dokončení, poté dotazování, dokud není analýza hotová.
  4. Zpráva: zjištění, které kontroly běžely a které ne.
  5. Náhled ceny.

Tok s curl

Přečtěte, co lze objednat. K tomu není token potřeba:

curl -s $API/v1/capabilities | jq '.options[].id'

Otevřete hostovskou relaci. Token se zobrazí jednou a platí 30 dní:

T=$(curl -s -X POST $API/v1/guest-sessions | jq -r .token)

Ohlaste soubor. Odpověď obsahuje uploadId, designId, uploadUrl a requiredHeaders:

J=$(curl -s -X POST $API/v1/uploads -H "authorization: Bearer $T" -H 'content-type: application/json' \
  -d "{\"fileName\":\"board.zip\",\"sizeBytes\":$(stat -c %s $F),\"sha256\":\"$(sha256sum $F | cut -d' ' -f1)\",\"purpose\":\"design\"}")

Pošlete soubor na adresu, kterou odpověď jmenuje, s každým záhlavím v requiredHeaders (typ obsahu, délka a kontrolní součet; bez nich je nahrání odmítnuto s 403). Poté nahrání dokončete:

curl -s -X PUT --data-binary @$F \
  $(echo $J | jq -r '.requiredHeaders | to_entries[] | "-H \(.key):\(.value)"') \
  "$(echo $J | jq -r .uploadUrl)"
curl -s -X POST $API/v1/uploads/$(echo $J | jq -r .uploadId)/complete -H "authorization: Bearer $T" | jq .design.status

Stav je nejprve analysing. Čtěte návrh, dokud se nezmění. Když je ready, zpráva je v odpovědi:

D=$(echo $J | jq -r .designId)
curl -s $API/v1/designs/$D -H "authorization: Bearer $T" | jq '.design.status, .report.headline, .report.counts'

Nadpis je no_problems_in_checks_run, problems_found nebo could_not_check. Čtěte také checksRun a checksNotRun: kontrola, která neběžela, není splněná. Další stavy jsou needs_mapping (nastavte vrstvy pomocí PUT /v1/designs/{designId}/layer-mapping), needs_engineer a rejected.

Požádejte o náhled ceny. selection a destinationCountry jsou povinné; prázdná selection vezme výchozí hodnoty:

curl -s -X POST $API/v1/quote-previews -H "authorization: Bearer $T" -H 'content-type: application/json' \
  -d "{\"designId\":\"$D\",\"quantities\":{\"boardsFabricated\":10,\"boardsAssembled\":0},\"selection\":{},\"destinationCountry\":\"DE\"}" \
  | jq '.mode, .reviewReasons, .totalMinor'

mode je instant (cena platí, jak je zobrazena) nebo review (inženýr ji potvrdí); reviewReasons říká proč. totalMinor je v minoritních jednotkách měny odpovědi currency a chybí, když inženýr musí zakázku ocenit. K uložení nabídky POST /v1/quotes bere stejné tělo.

Stejný tok s JavaScript klientem

Klient @ulike/sdk tyto trasy obaluje. Je klientem našeho vlastního webu a není veřejným balíčkem; toto je jeho tvar, abyste stejná volání mohli psát s fetch. Názvy metod:

import { createClient } from '@ulike/sdk';

let token;
const api = createClient({ baseUrl: 'https://uliketechnology.com/api', token: () => token });

const caps = await api.capabilities();
token = (await api.createGuestSession()).token;
const started = await api.uploadDesign({ name: 'board.zip', bytes }); // announce, PUT, complete
const view = await api.waitForDesign(started.design.id); // polls getDesign
const preview = await api.previewQuote({
  designId: view.design.id,
  quantities: { boardsFabricated: 10, boardsAssembled: 0 },
  selection: {},
  destinationCountry: 'DE',
});

Další metody jsou createUpload, completeUpload, getDesign, setLayerMapping, validateDesign, getValidation, waitForValidation, createQuote, getQuote, reviseQuote, listAddresses, placeOrder, getOrder, listOrders a cancelOrder. Chyby se vyhazují jako ApiClientError se status a code.

Kontrola pro objednávku

Zpráva, kterou dostanete po nahrání, je vytvořena jen ze souborů. Ke kontrole souborů vůči objednávce volejte POST /v1/designs/{designId}/validations (validateDesign) s order obsahujícím quantities a selection. Odpověď je stav: running, failed nebo done. Zatímco je running, čtěte GET /v1/validations/{reportId} (getValidation) každou sekundu nebo dvě, dokud není done.

Smyčka tří kroků: nahrát soubory, přečíst zprávu, opravit a nahrát znovu; šipka opouští smyčku k zatržítku, když jsou soubory čisté
  1. Nahrajte zip archiv.
  2. Přečtěte zprávu.
  3. Opravte a nahrajte jako nový návrh. Zastavte a zeptejte se osoby, když oprava mění funkci, cenu nebo dodací lhůtu.
  4. Čisté soubory: spusťte kontrolu pro objednávku.

Nabídka nebo náhled s volbami, které přinášejí jiné limity (silnější měď, jiná tloušťka), potřebuje kontrolu pro tento výběr. Pokud žádná není, jedna se spustí a náhled nese důvod technické kontroly file_check_pending a check s jeho reportId. Cena se zobrazí ihned, ale nabídka zůstane v review, dokud tato kontrola není hotová. Čtěte kontrolu jako výše a poté požádejte o náhled znovu.

Chyby, které potkáte

Kód Stav Co to znamená Co dělat
DESIGN_NOT_READY 422 Návrh se stále čte (details.status říká, v jakém stavu), nebo ještě nemá zprávu. Čtěte návrh, dokud stav není analysing, poté se zeptejte znovu.
VALIDATION_FAILED 400 Požadavek nemá očekávaný tvar nebo jmenuje volbu či hodnotu, kterou katalog nemá. details uvádí body nebo problémy. Opravte pole jmenované v details a pošlete znovu. Berte ID voleb a hodnoty z GET /v1/capabilities.
NOT_MANUFACTURABLE 422 Výběr je něco, co nevyrábíme. details.because nese důvody. Změňte výběr; nezkoušejte stejný znovu. Zeptejte se osoby, zda by změna změnila desku.
ANONYMOUS_BUDGET_SPENT 429 Denní příděl bez účtu je vyčerpán. details.resetsOn je datum. Zastavte. Řekněte to osobě; může se přihlásit nebo počkat do toho data.
REVISION_CONFLICT 409 Revize jmenovala základ, který už není hlavou nabídky. details nese obě hlavy. Přečtěte hlavu pomocí GET /v1/quotes/{quoteId}, znovu použijte svou změnu na ni a pošlete znovu.

Možné jsou také DESIGN_REJECTED (nahrání bylo odmítnuto; viz details.reason), UNAUTHENTICATED pro chybějící nebo špatný token (špatný token je odmítnut i na veřejných trasách), FORBIDDEN pro klíč nebo hostovský token, který trasu volat nesmí, a FEATURE_DISABLED pro trasu, která je vypnutá.

Denní příděl bez účtu

Hostovská relace má denní příděl výpočtu. Nahrání a spuštěné kontroly stojí více než prosté čtení a otevírání mnoha hostovských relací z jedné síťové adresy se také počítá. Kontrola, kterou web sám spustí pro nový výběr, se účtuje na stejný příděl. Když je vyčerpán, dostanete ANONYMOUS_BUDGET_SPENT s datem, kdy se resetuje. Přihlášení volající se takto nepočítají.

Od nabídky k objednávce

Objednávka se zadává z uložené nabídky, která patří k účtu. Hostovský token je na trasách objednávek odmítnut. Program pracuje pro účet jedním ze dvou způsobů, oba popsané na Pro vývojáře a asistenty:

  • Klíč API. Osoba jej vytvoří ve svém účtu v části Klíče API a vybere, co smí dělat. Pošlete jej jako Authorization: Bearer ulk_…. Nabídka vytvořená klíčem patří k účtu. Testovací klíč (ulk_test_…) funguje jen na ukázkových datech.
  • Přihlášení pro programy. Asistent se sám zaregistruje, osoba na stránce webu uvidí, o co žádá, a stiskne Povolit, a asistent dostane token omezený na tato oprávnění.

Uložené adresy čtěte pomocí GET /v1/addresses. Adresu přidává nebo mění osoba v prohlížeči. Adresa pro dopravu musí být v destinationCountry nabídky.

Objednávku zadejte pomocí POST /v1/orders. Trasa potřebuje záhlaví Idempotency-Key: jeden nový klíč o 8 až 80 viditelných znacích pro každou zamýšlenou objednávku a tentýž klíč znovu, když to zkoušíte znovu:

curl -s -X POST $API/v1/orders -H "authorization: Bearer $KEY" -H 'content-type: application/json' \
  -H "idempotency-key: $(uuidgen)" \
  -d "{\"quoteId\":\"$Q\",\"expectedTotalMinor\":$TOTAL,\"shipToAddressId\":\"$SHIP\",\"billToAddressId\":\"$BILL\",\"paymentMethod\":\"bank_transfer\",\"termsVersion\":\"$TERMS\",\"dangerousGoods\":false}"

expectedTotalMinor je totalMinor nabídky, se kterým osoba souhlasila. termsVersion jmenuje verzi prodejních podmínek, kterou osoba přijala. dangerousGoods říká, zda zásilka obsahuje baterie nebo jiné nebezpečné zboží.

Tímto voláním není nic zadáno. Odpovědí je APPROVAL_REQUIRED (422) s details.approvalUrl, pro klíč API i pro token asistenta, který se přihlásil, stejně. Dejte tento odkaz osobě. Otevře jej, přihlásí se, uvidí objednávku a celkovou částku a schválí nebo odmítne. Odkaz funguje jednou, vyprší po 24 hodinách a přestane fungovat, pokud se nabídka nebo celková částka změní.

Po schválení objednávka existuje: objednávky účtu vypište pomocí GET /v1/orders a jednu čtěte pomocí GET /v1/orders/{orderId}. Nese order.number, číslo proforma faktury v proFormaNumber, účet k zaplacení v sellerBank a, pod payments, bankReference k napsání na převod.

Platba je bankovním převodem, provedeným osobou. Žádný klíč ani asistent platit nemůže. Objednávku sledujte pomocí GET /v1/orders/{orderId}. Inženýr potvrdí každou objednávku před výrobou.

Kód Stav Co to znamená Co dělat
APPROVAL_REQUIRED 422 Přihlášená osoba musí nejprve schválit. details.approvalUrl je stránka. Dejte odkaz osobě. Nehledějte cestu kolem toho.
TOTAL_MISMATCH 422 expectedTotalMinor není celkovou částkou nabídky. details.totalMinor je celková částka. Nabídku přečtěte znovu a cenu osobě ukažte, než se zeptáte znovu.
QUOTE_EXPIRED 410 Nabídka je po své platnosti. Nabídku upravte pro novou cenu a ukažte ji osobě.
CONFLICT 409 details.reason je quote_ordered nebo quote_not_priced (inženýr musí nejprve dát cenu). Nezkoušejte znovu. Řekněte to osobě.
INTAKE_CLOSED 503 Objednávky se nyní nepřijímají. details.reopensOn je datum, pokud nějaké je. Zastavte. Řekněte to osobě.

Táž služba je asistentům nabízena jako pojmenované nástroje přes server MCP: viz Co je MCP a jak agenti objednávají.