Product-offer /endpoint

API Dla Dystrybutora

Zastosowanie


Endpoint /product-offer służy do aktualizacji ofert. 

Specyfikacja PATCH


Request

HTTP POST https://drinks2cash.com/api/product-offer

Authorization: <api_key_dystrybutora>

Content-Type: application/json

Body:

[
    {
        "sku": string,
        "is_active": boolean
    },
    {
        "sku": string,
        "is_active": boolean
    }
]

Poprawny przykład:

[
    {
        "sku": "123",
        "is_active": true
    },
    {
        "sku": "234",
        "is_active": false
    }
]

Swój api_key znajdziesz na stronie:

https://drinks2cash.com/order/admin-importer

Responses

HTTP 200 – OK

Body:

{
    "code": 200,
    "reasonPhrase": "OK",
    "data": {
        "count": {
            "updated": 2,
            "errors": 0
        },
        "updated": [
            {
                "sku": "POR CHA WHI",
                "is_active": "true"
            },
            {
                "sku": "ALE_SPR_HAZ_BUT_500",
                "is_active": "false"
            }
        ],
        "errors": []
    }
}

Operacja zakończona sukcesem w każdej pozycji. System próbuje zaktualizować każdą pozycję. Wszystkie zaktualizowane pozycje są w „updated”, pozycje z błędami są w „errors”.

HTTP 200 – OK

Żądanie zostało poprawnie przetworzone, ale ma błedy w poszczególnych pozycjach:

Body:

{
    "code": 200,
    "reasonPhrase": "OK",
    "data": {
        "count": {
            "updated": 0,
            "errors": 2
        },
        "updated": [],
        "errors": [
            {
                "sku": "POR CHA WHsI",
                "code": 404,
                "error": "SKU not found"
            },
            {
                "sku": "ALE_SPR_HAZ_BUT_500",
                "code": 422,
                "error": {
                    "is_active": {
                        "callbackValue": "is_active must be either true or false"
                    }
                }
            }
        ]
    }
}

Jeżeli w pozycji jest błąd 422 to jest to błąd walidacji, 404 nie znaleziono sku.

HTTP 403 – Forbidden

Body:

{
    "code": 403,
    "reasonPhrase": "Forbidden",
    "data": "Unauthorised"
}

Nie zidentyfikowano użytkownika. Sprawdź, czy podałeś poprawne api_key, znajdziesz je w swoim panelu administracyjnym w zakładce Drinks2cash – Panel administracyjnydrinks2cash.com/order/admin-importer

HTTP 400 – Bad request

Jeżeli format json-a jest niepoprawny, lub wysłano pustą listę:

Przykład:

{
    "code": 400,
    "reasonPhrase": "Bad Request",
    "message": "Invalid request, missing data. Most likely you sent an empty list or json is invalid."
}

HTTP 500 – Internal Server Error

Przykład:

{
    "code": 500,
    "reasonPhrase": "Internal Server Error",
    "message": "We cannot process your request right now, please try again later."
}