Елді мекендердің API

Сұрауларда міндетті түрде мына тақырып көрсетіледі:

Жалпыға ортақ API кез-келген әзірлеушіге авторизация белгісінсіз қол жетімді. Қоғамдық API шектеулі функционалдылыққа ие, оны елді мекендерді іздеу, базалық мөлшерлеме бойынша тарифтерді есептеу және шот-фактураларды қадағалау үшін пайдалануға болады.

Елді мекендерді атауы бойынша іздеу.

Сервер title параметрінде көрсетілген таңбалардан басталатын жөнелтілімдерді жинайтын елді мекендердің тізімін қайтарады.

Сұрау мысалы:

Сервердің жауабы:

{
  "regions": [
    { "id":4,"title":"Астана","cached_path":"Казахстан" },
    { "id":124,"title":"Астрахань","cached_path":"Россия, Астраханская область" }
  ],
  "meta": {
    "total":2
  }
}

id – елді мекеннің идентификаторы

title – Елді мекеннің атауы

cached_path – Аймаққа қатыстылығы

meta: total – табылған жазбалар саны

Елді мекендерді атауы бойынша іздеу

Сервер title параметрінде көрсетілген таңбалардан басталатын жеткізужөнелтілімдер жүргізілетін елді мекендердің тізімін қайтарады.

Сұрау мысалы:

Сервердің жауабы:

{
  "regions": [
    { "id":4,"title":"Астана","cached_path":"Казахстан" },
    { "id":124,"title":"Астрахань","cached_path":"Россия, Астраханская область" }
  ],
  "meta": {
    "total":2
  }
}

id – елді мекеннің идентификаторы

title – Елді мекеннің атауы

cached_path – Аймаққа қатыстылығы

meta: total – табылған жазбалар саны

Ел коды бойынша барлық елді мекендер (alpha-2 ISO)

Сервер көрсетілген елдегі жөнелтімдерді жинау жүргізілетін барлық елді мекендердің тізімін қайтарады. Назар аударыңыз! Қазіргі уақытта тек Қазақстан (KZ) ғана қолжетімді.

Сұрау мысалы:

Сервердің жауабы:

{
  "regions": [
    {"id":3,"title":"Астана","cached_path":"Казахстан","zone":"kz_1",
          "origin":true,"destination":true},
    {"id":5,"title":"Байконур","cached_path":"Казахстан","zone":"kz_2",
          "origin":true,"destination":true},
    ...
    {"id":22,"title":"Талдыкорган","cached_path":"Казахстан, Алматинская область", "zone":"kz_1",
          "origin":true,"destination":true}
  ],
  "meta": {
    "total": 28
  }
}

id – елді мекеннің идентификаторы

title – Елді мекеннің атауы

cached_path – Аймаққа қатыстылығы

zone – Тарифтік аймақ

origin – Алым бар ма

destination – Жеткізу бар ма

meta: total – табылған жазбалар саны

Ел коды бойынша барлық елді мекендер (alpha-2 ISO)

Сервер көрсетілген елдегі жөнелтімдерді жинау жүргізілетін барлық елді мекендердің тізімін қайтарады. Назар аударыңыз! Қазіргі уақытта тек Қазақстан (KZ) ғана қолжетімді.

Сұрау мысалы:

Сервердің жауабы:

{
  "regions": [
    {"id":3,"title":"Астана","cached_path":"Казахстан","zone":"kz_1",
            "origin":true,"destination":true},
    {"id":5,"title":"Байконур","cached_path":"Казахстан","zone":"kz_2",
            "origin":true,"destination":true},
    ...
    {"id":22,"title":"Талдыкорган","cached_path":"Казахстан, Алматинская область",
            "zone":"kz_1","origin":true,"destination":true}
  ],
  "meta": {
    "total": 28
  }
}

id – елді мекеннің идентификаторы

title – Елді мекеннің атауы

cached_path – Аймаққа қатыстылығы

zone – Тарифтік аймақ

origin – Алым бар ма

destination – Жеткізу бар ма

meta: total – табылған жазбалар саны

Тарифті есептеу

Сервер жеткізу құнын және жеткізу уақыты туралы қысқаша ақпаратты қайтарады.

Сұрау мысалы:

Сервердің жауабы:

{
  "calculation": {
    "price": "3000.00",
    "fuel_surplus": "300.00",
    "declared_value_fee": "150.00",
    "vat": "0.00",
    "human_range": "24 декабря - 26 декабря",
    "min": 3,
    "max": 5
  }
}

price – Қызмет құны

fuel_surplus – Қызмет құны

declared_value_fee – Жарияланған құндылық үшін төлем

min – Жеткізудің ең аз мерзімі жұмыс күндері

max – Жеткізудің максималды мерзімі жұмыс күндері

human_range – Күтілетін жеткізу аралығы ыңғайлы түрде (демалыс және мереке күндерін ескере отырып)

Қызмет сұрауында көрсетілмеген сұрау мен жауап мысалы

Сервердің жауабы:

{
  "calculations": {
    "standard": {
      "price": "3000.00",
      "fuel_surplus": "300.00",
      "declared_value_fee": "150.00",
      "vat": "0.00",
      "human_range": "24 декабря - 26 декабря",
      "min": 3,
      "max": 5
    },
    "express_mail": {
      "price": "4350.00",
      "fuel_surplus": "435.00",
      "declared_value_fee": "150.00",
      "vat": "0.00",
      "human_range": "20 декабря - 23 декабря",
      "min": 1,
      "max": 2
    },
    "express_parcels": {
      "price": "4350.00",
      "fuel_surplus": "435.00",
      "declared_value_fee": "150.00",
      "vat": "0.00",
      "human_range": "20 декабря - 23 декабря",
      "min": 1,
      "max": 2
    }
  }
}

standard – Стандартты тариф үшін есептеу мәліметтері

express – Экспресс тариф үшін есептеу мәліметтері

Жеткізу мерзімдерін есептеу

Сервер тізімді қайтарады қол жетімді жеткізу уақыты. Егер бірде-бір параметр берілмесе, барлық елді мекендер үшін барлық жеткізу мерзімдерін қайтарады.

Сұрау мысалы:

Сервердің жауабы:

{
  "trails": [
    {
      "id": 3,
      "service": "express",
      "origin": "Алматы",
      "destination": "Астана",
      "min": 1,
      "max": 3,
      "min_date": "2015-03-06",
      "max_date": "2015-03-11",
      "human_range": "06 – 11 марта",
      "definitely_holidays": [],
      "maybe_holidays": ["Международный женский день"],
      "definitely_weekends": [],
      "maybe_weekends": ["2015-03-07","2015-03-08"]
    }
  ],
  "meta": {
    "total": 1
  }
}

origin – Жөнелту пункті

destination – Жеткізу орны

min – Жеткізудің ең аз мерзімі жұмыс күндері

max – Жеткізудің максималды мерзімі жұмыс күндері

min_date – Жеткізудің ең аз күні (демалыс және мереке күндерін ескере отырып)

max_date – Жеткізудің максималды күні (демалыс және мереке күндерін ескере отырып)

human_range – Күтілетін жеткізу аралығы ыңғайлы түрде

definitely_holidays – Жеткізу мерзіміне дәл келетін мерекелер

maybe_holidays – Жеткізу мерзіміне жетуі мүмкін мерекелер

definitely_weekends – Демалыс күндері (сенбі, жексенбі), олар жеткізу мерзіміне дәл келеді

maybe_weekends – Жеткізу мерзіміне жетуі мүмкін демалыс күндері (сенбі, жексенбі)

meta: total – табылған жазбалар саны