API dokumentācija

Pieslēdziet to savai programmatūrai.

Publicējiet cenas, pārbaudiet adreses un nododiet vēstules tieši no savas drukas sistēmas, bez manuālām darbībām.

Pieprasīt API piekļuvi

Darba uzsākšana.

  1. 01

    Pieprasiet piekļuvi

    Pieprasiet API piekļuvi, un mēs sagatavosim jūsu centru.

  2. 02

    Saņemiet atslēgu

    Katram centram ir sava API atslēga.

  3. 03

    Izmēģiniet testa režīmā

    Testa režīms darbojas ar paraugdatiem, tāpēc nekas netiek nosūtīts.

Pieejamie galapunkti.

Katrs pieprasījums tiek autentificēts ar jūsu API atslēgu. api.postgraph.com

PUT/v1/prices

Publicējiet savas cenas

Publicējiet, cik maksā jūsu centrs. Citi centri to redz.

Pieprasījums
curl -X PUT https://api.postgraph.com/v1/prices \
  -H "Authorization: Bearer $POSTGRAPH_KEY" \
  -d '{
    "print": 0.14,
    "paper": 0.06,
    "envelope": 0.05,
    "processing": 0.22,
    "delivery": 0.77
  }'
Atbilde 200 OK
{
  "centre": "ctr_hudson",
  "currency": "EUR",
  "total": 1.24,
  "published": true
}

GET/v1/prices

Apskatiet tirgu

Iegūstiet cenas, ko publicējuši valsts centri.

Pieprasījums
curl "https://api.postgraph.com/v1/prices?country=US" \
  -H "Authorization: Bearer $POSTGRAPH_KEY"
Atbilde 200 OK
{
  "country": "US",
  "currency": "EUR",
  "centres": [
    { "id": "ctr_lakeshore", "total": 1.33 },
    { "id": "ctr_hudson", "total": 1.24 }
  ]
}

POST/v1/compare

Atrodiet lētāko centru

Salīdziniet paša izdarītu ar nodošanu ārzemēs.

Pieprasījums
curl https://api.postgraph.com/v1/compare \
  -H "Authorization: Bearer $POSTGRAPH_KEY" \
  -d '{
    "country": "US"
  }'
Atbilde 200 OK
{
  "own_cost": 2.97,
  "best": {
    "centre": "ctr_hudson",
    "total": 1.24
  },
  "saving": 1.73,
  "currency": "EUR"
}

POST/v1/addresses/validate

Pārbaudiet adresi

Pārbauda formātu un prasības. Adresi nekad nemaina.

Pieprasījums
curl https://api.postgraph.com/v1/addresses/validate \
  -H "Authorization: Bearer $POSTGRAPH_KEY" \
  -d '{
    "country": "DE",
    "lines": ["Max Mustermann", "Musterstraße 12"],
    "postcode": "10115"
  }'
Atbilde 200 OK
{
  "valid": true,
  "checks": {
    "format": "pass",
    "postcode": "pass",
    "requirements": "pass"
  }
}

POST/v1/handovers

Nododiet vēstuli

Nosūtiet vēstuli izvēlētajam centram izdrukāšanai un nosūtīšanai.

Pieprasījums
curl https://api.postgraph.com/v1/handovers \
  -H "Authorization: Bearer $POSTGRAPH_KEY" \
  -d '{
    "centre": "ctr_hudson",
    "letter": "ltr_3k91"
  }'
Atbilde 200 OK
{
  "id": "hnd_41c7",
  "status": "sent",
  "centre": "ctr_hudson",
  "total": 1.24,
  "currency": "EUR"
}

Gatavi pievienoties?

Pievienošanās ir bezmaksas. Pastāstiet par savu drukas centru, un mēs palīdzēsim ar visu pārējo.

Pieteikties