Dla programistów

Prynt udostępnia publiczne API GraphQL, przez które systemy drukarni i jej partnerów czytają i zapisują dane w Prynt: zamówienia, klientów, magazyn, produkcję i faktury. Ta sekcja jest dla programistów, którzy budują taką integrację: w firmie drukarni albo na jej zlecenie.

Jak działa API

• Jedna drukarnia, jeden adres. Każda drukarnia ma w Prynt własną, oddzieloną instalację, więc i własny adres API, np. https://twoja-drukarnia.prynt.pl/api/v1/graphql. Klucz działa tylko w instalacji, dla której go wydano.
• GraphQL. Jeden punkt końcowy, zapytania i mutacje wysyłane metodą POST w formacie JSON. Pełny schemat pobierzesz z referencji API.
• Integracja to konto. Integracja działa w Prynt jak osobne konto z własną nazwą, np. „Sklep internetowy”. Wszystko, co zapisze przez API, ma ją jako autora, a w historii zmian widać przy niej oznaczenie Integracja.
• Klucze za akceptacją Prynt. O integrację wnioskuje administrator drukarni, a Prynt ją zatwierdza. Dopiero potem administrator wydaje klucz API.
• Zakresy. Integracja dostaje tylko zakresy, o które drukarnia wnioskowała i które zatwierdził Prynt, np. orders:read. Klucz nie widzi operacji ani pól spoza swoich zakresów.

Co możesz zbudować

Sklep internetowy

Przekazuj zamówienia ze sklepu do Prynt razem z kupującym i plikami do druku, a klientom pokazuj status i postęp produkcji. Zakresy orders:write, orders:read, clients:read, clients:write, files:write, production:read.

Księgowość i ERP

Pobieraj faktury z dokumentami, płatności i dane klientów do systemu finansowego. Zakresy invoices:read, orders:read, prices:read, files:read, clients:read.

CRM

Synchronizuj klientów, osoby kontaktowe i notatki między CRM a Prynt. Zakresy clients:read, clients:write.

Hurtownia danych i BI

Zbieraj stany i ruchy magazynowe, zamówienia zakupu i zadania produkcyjne do raportów. Zakresy warehouse:read, production:read, a dla wartości magazynu prices:read. Postęp produkcji przy zamówieniach wymaga też orders:read.

Które operacje są dostępne w każdym zakresie, pokazuje referencja API. Pełną listę zakresów znajdziesz na stronie Zakresy.

Jak zacząć

1. Ustal zakres z drukarnią. Zapiszcie, jakie dane integracja ma czytać i zapisywać. Z tego wynikają potrzebne zakresy.

2. Administrator drukarni składa wniosek w Konfiguracja → Integracje → Integracje API (instrukcja dla niego: Integracje API). Prynt sprawdza wniosek i decyduje. Szczegóły: Dostęp i akceptacja.

3. Administrator wydaje klucz i przekazuje Ci go bezpiecznym kanałem. Klucz jest widoczny tylko raz. Jak go przechowywać: Uwierzytelnianie.

4. Wyślij pierwsze zapytanie, korzystając z Szybkiego startu.

Przewodniki

Szybki startPierwsze zapytanie w pięć minut: adres, klucz, curl.

Podstawy GraphQL w PryntFormat żądań i odpowiedzi, schemat do pobrania, narzędzia.

Zapisy i idempotencjaMutacje, nagłówek Idempotency-Key i bezpieczne ponowienia.

Technologia zamówieniaElementy, operacje, maszyny i formaty arkuszy z kalkulacji; zamówienia z poprzedniego systemu.

MagazynKarty papieru, farb i folii, stany, ruchy i kolor farby z wzorców Pantone do pobrania.

LimityŻądania na minutę, głębokość, rozmiar strony i koszt zapytania.

BłędyKoperta błędu, kategorie i sub-kody z zaleceniem, co zrobić.

WersjonowanieStabilność operacji, zmiany niełamiące i okres wycofania.

Pomoc

Pytania o API wysyłaj na [email protected]. Podaj adres drukarni, nazwę integracji i requestId z odpowiedzi, której dotyczy pytanie. Nigdy nie wysyłaj nam klucza API: Prynt nigdy o niego nie prosi. Podatność zgłoś według zasad na stronie Bezpieczeństwo.