База со податоци на вино и детали.
Потребно е да сте најавен корисник за да можете да го користите сервисот.
Најавата / регистрацијата ја упростивме на најлесниот можен начин. Потребно е само да се најавите со вашиот Google / Gmail профил. После најавата во полето за токен (подоле) ќе можете да го користите Вашиот личен токен на PHP.mk сервисите.
Личен токен
За да се прикаже токенот, потребна е најава!
Верзија ({верзија}): 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 } }