Wine API service

Wine API service / Сервис за вино

 

Основни информации

База со податоци на вино и детали.

 

Токен и автентикација на сервис

Потребно е да сте најавен корисник за да можете да го користите сервисот.

Најавата / регистрацијата ја упростивме на најлесниот можен начин. Потребно е само да се најавите со вашиот Google / Gmail профил. После најавата во полето за токен (подоле) ќе можете да го користите Вашиот личен токен на PHP.mk сервисите.

Личен токен

За да се прикаже токенот, потребна е најава!

 

Користење на сервисот v1.0

Верзија ({верзија}): v1.0

Вино за кое пребарувате детали ({wine}): ?q= пр. "Kamnik Cuve"

Сервис end-point

HTTP/GET

https://api.php.mk/wine/{верзија}?token={token}&q={wine+winery}

Пример HTTP/GET request

https://api.php.mk/wine/v1.0/search?token=&q=Kamnik+Cuve

Пример PHP

$url='https://api.php.mk/wine/v1.0/search?token=&q=Kamnik+Cuve';
$jsonResponse=file_get_contents($url);
$response= json_decode($jsonResponse,true);
            
echo '<pre>';
print_r($response['data']);
exit();

Пример cUrl

curl -X GET  'https://api.php.mk/wine/v1.0/search?token=&q=Kamnik+Cuve';

Пример Javascript

var xhr = new XMLHttpRequest();
xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    var response_data=JSON.parse(this.responseText).data;
    console.log(response_data);
  }
});
xhr.open("GET", "https://api.php.mk/wine/v1.0/search?token=&q=Kamnik+Cuve");
xhr.send();

Пример jQuery / JavaScript

$.getJSON('https://api.php.mk/wine/v1.0/search?token=&q=Kamnik+Cuve',function(r){

    console.log(r.data);

}).fail(function(error){

    console.log(error.responseJSON.msg);

});

 

Одговор од сервисот

Одговорот е секогаш во JSON формат

Одговорот од сервисот e во JSON формат и содржи листа од пронајдени вина по клучниот термин

Пример од одговор

{
    "error": false,
    "status_text": "OK",
    "status_code": 200,
    "data": [
        {
            "id": "1124130",
            "name": "Kamnik Cuvée de Prestige",
            "details_url": "https://api.php.mk/wine/v1.0/info/1124130?token=",
            "details": {
                "winery": "Kamnik",
                "region": "Skopje",
                "country": {
                    "code": "mk",
                    "name": "Macedonia",
                    "native_name": "Македонија"
                },
                "image": {
                    "main": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_480x640.png",
                    "images": {
                        "bottle_large": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_x960.png",
                        "bottle_medium": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_x600.png",
                        "bottle_medium_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_600x600.png",
                        "bottle_small": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_x300.png",
                        "bottle_small_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_300x300.png",
                        "label": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_480x640.png",
                        "label_large": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_375x500.png",
                        "label_medium": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x200.png",
                        "label_medium_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x150.png",
                        "label_small_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_80x80.png",
                        "large": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_375x500.png",
                        "medium": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x200.png",
                        "medium_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x150.png",
                        "small_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_80x80.png"
                    }
                },
                "alcohol_percent": null
            }
        }
    ]
}

Пример од одговор (за датален преглед на вино)

{
    "error": false,
    "status_text": "OK",
    "status_code": 200,
    "data": {
        "id": 1124130,
        "name": "Cuvée de Prestige",
        "slug": "cuvee-de-prestige",
        "region": {
            "id": 1430,
            "name": "Skopje",
            "slug": "skopje",
            "country": {
                "code": "mk",
                "name": "Macedonia",
                "native_name": "Македонија",
                "currency": {
                    "code": "MKD",
                    "name": "Macedonian Denar",
                    "prefix": null,
                    "suffix": " ден."
                }
            }
        },
        "winery": {
            "id": 12364,
            "name": "Kamnik",
            "slug": "kamnik"
        },
        "description": "",
        "grapes": [
            {
                "id": 10,
                "name": "Merlot",
                "slug": "merlot",
                "verified_source": true,
                "wines_count": 428279
            }
        ],
        "foods": [
            {
                "id": 4,
                "name": "Beef",
                "image": {
                    "main": "https://api.php.mk/wine/v1.0/image?token=&path=backgrounds/foods/LRul-gKxSQ68KeIwT_xY-A.jpg",
                    "images": {
                        "small": "https://api.php.mk/wine/v1.0/image?token=&path=backgrounds/foods/thumbs/LRul-gKxSQ68KeIwT_xY-A_932x810.jpg"
                    }
                },
                "slug": "beef"
            },
            {
                "id": 11,
                "name": "Game (deer, venison)",
                "image": {
                    "main": "https://api.php.mk/wine/v1.0/image?token=&path=backgrounds/foods/JRI-5ewpQYOMrA2YuKWAlA.jpg",
                    "images": {
                        "small": "https://api.php.mk/wine/v1.0/image?token=&path=backgrounds/foods/thumbs/JRI-5ewpQYOMrA2YuKWAlA_932x810.jpg"
                    }
                },
                "slug": "game"
            }
        ],
        "image": {
            "main": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_480x640.png",
            "images": {
                "bottle_large": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_x960.png",
                "bottle_medium": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_x600.png",
                "bottle_medium_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_600x600.png",
                "bottle_small": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_x300.png",
                "bottle_small_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pb_300x300.png",
                "label": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_480x640.png",
                "label_large": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_375x500.png",
                "label_medium": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x200.png",
                "label_medium_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x150.png",
                "label_small_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_80x80.png",
                "large": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_375x500.png",
                "medium": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x200.png",
                "medium_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_150x150.png",
                "small_square": "https://api.php.mk/wine/v1.0/image?token=&path=thumbs/Ls9WjWA4TGyNTZM_-gv-7Q_pl_80x80.png"
            }
        },
        "alcohol_percent": null
    }
}