რას ნიშნავს API?

API-ის შემოკლება Application Programming Interface-ისთვის ნიშნავს ფუნქციების კოდების ერთობლიობას, რომელიც აპლიკაციებს საშუალებას აძლევს წვდომა მიიღონ მითითებულ მონაცემებზე და ურთიერთქმედონ გარე პროგრამული აპლიკაციების კომპონენტებთან, ოპერაციულ სისტემებთან ან მიკროსერვისებთან.

გამარტივების მიზნით, API აწვდის მომხმარებლის პასუხს სისტემას და უგზავნის სისტემის პასუხს მომხმარებელს. თქვენ დააწკაპუნეთ "კალათაში დამატება"; API ეუბნება საიტს, რომ თქვენ დაამატეთ პროდუქტი თქვენს კალათაში; ვებგვერდი ათავსებს პროდუქტს თქვენს კალათაში და თქვენი კალათა განახლდება.

შეიძლება მოისმინოთ ტერმინი „მიკროსერვისები“ API-სთან დაკავშირებით. თუმცა, ეს არ არის იგივე. მიკროსერვისები არის სტილი ან არქიტექტურა, რომელიც ანაწილებს ფუნქციებს ვებ აპლიკაციის ფარგლებში. მიუხედავად იმისა, რომ API არის ჩარჩო, რომელიც დეველოპერები ურთიერთობენ ვებ აპლიკაციასთან. მიკროსერვისებს რეალურად შეუძლიათ გამოიყენეთ API კომუნიკაციისთვის ერთმანეთს შორის.

API საშუალებას აძლევს დეველოპერს განახორციელოს კონკრეტული „ზარი“ ან „მოთხოვნა“ ინფორმაციის გაგზავნის ან მიღების მიზნით. ეს კომუნიკაცია ხორციელდება პროგრამირების ენის გამოყენებით, სახელწოდებით "JSON". ის ასევე შეიძლება გამოყენებულ იქნას განსაზღვრული მოქმედების შესასრულებლად, როგორიცაა მონაცემების განახლება ან წაშლა. არსებობს ოთხი ძირითადი მოთხოვნის მეთოდი, რომელიც შეიძლება გაკეთდეს API-ით:

GET - აგროვებს ინფორმაციას (ყველა კუპონის კოდის ამოღება)

PUT - განაახლებს მონაცემთა ნაწილებს (პროდუქტის ფასების განახლება)

POST – ქმნის (პროდუქტის ახალი კატეგორიის შექმნა)

წაშლა – (ბლოგის პოსტის წაშლა)

რა არის JSON და რატომ გამოიყენება?

JSON (JavaScript Object Notation) გამოიყენება სერვერზე მონაცემების წარმოსაჩენად. ის საკმაოდ ადვილად იკითხება ადამიანებისთვის და ადვილად გასაგები მანქანებისთვის/აპლიკაციებისთვის. მოდით შევხედოთ JSON-ის მაგალითს BigCommerce-ის პროდუქტიდან:

ამის გაგება ადვილია, რადგან ის გამოტანილია გასაღების/მნიშვნელობის წყვილებში, გასაღები მარცხნივ და მნიშვნელობა მარჯვნივ. გასაღებები არის ფიქსირებული ობიექტი, რომელიც განსაზღვრულია აპლიკაციის მიერ და დარჩება იგივე, რაც "კატეგორიაში". მაშინ როდესაც ღირებულებები იქნება უნიკალური, როგორიცაა "პერანგები".

რა არის API მოთხოვნა?

არსებობს API მოთხოვნის რამდენიმე კომპონენტი, რათა ის იმუშაოს. მოდით განვიხილოთ ეს ინდივიდუალურად და როგორ შეიძლება მათი გამოყენება მოთხოვნის შესაქმნელად.

რა არის საბოლოო წერტილი?

ბოლო წერტილის ორი ძირითადი ნაწილია, რომლებიც გამოიყენება API მოთხოვნის მიღებისას. ერთ-ერთი მათგანია URL. BigCommerce იყენებს https://api.bigcommerce.com/stores/, როგორც URL ყველა API მოთხოვნისთვის. ეს შეიძლება გამოიყურებოდეს როგორც ჩვეულებრივი URL, მაგრამ თუ შეაერთებთ მას ვებ ბრაუზერში, მიიღებთ 404 შეცდომის შეტყობინებას.

მეორე ნაწილი არის გზა. გზა განსხვავდება იმისდა მიხედვით, თუ რის მიღწევას ცდილობთ. შეგიძლიათ იპოვოთ BigCommerce-ისთვის ხელმისაწვდომი გზების სია ჩვენი დეველოპერის დოკუმენტაციის მონახულებით: https://developer.bigcommerce.com/api-reference. ამ მაგალითისთვის ჩვენ ვაპირებთ გამოვიყენოთ პროდუქტის გზა, რომელიც არის /v3/catalog/products.

როდესაც ამ ორ ნაწილს ერთად ვათავსებთ, მივიღებთ სრულ საბოლოო წერტილს https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products. ახლა შეიძლება საკუთარ თავს თქვათ "რა არის {store_hash}?" "საიდან გაჩნდა?" ეს არის ის, რაც ცნობილია როგორც ცვლადი. ცვლადები საბოლოო წერტილის უნიკალური კომპონენტებია და განსხვავდება თქვენი მაღაზიის ინფორმაციის მიხედვით. თქვენ შეგიძლიათ დააფიქსიროთ ცვლადი ღია და დახურული ფრჩხილებით „{ }“.

რა არის ჰედერი?

ჰედერები აწვდიან ინფორმაციას კლიენტს და სერვერს. სათაურის ჩვეულებრივი მაგალითები იქნება ავთენტიფიკაციის სერთიფიკატები, როგორიცაა "Auth Token" ან "Client ID". ეს რწმუნებათა სიგელები ავტომატურად მოგეწოდებათ API ანგარიშის შექმნისას. კიდევ ერთი გავრცელებული სათაური მოიხსენიება, როგორც "შინაარსის ტიპი", რომელიც აცნობებს სერვერს, თუ რა ტიპის კონტენტი გაიგზავნება. მაგალითად, საყოველთაოდ გამოყენებული კონტენტის ტიპია „აპლიკაცია/json“, რომელიც სერვერს აცნობებს, რომ ჩვენ JSON მონაცემებს ვაგზავნით.

რა არის მეთოდი?

მეთოდები არის მოქმედებები, რომლებიც განხორციელდა მოთხოვნის გაგზავნისას. დაფიქრდით საწყისზე, როდესაც განვიხილეთ GET, PUT, POST და DELETE. ეს არის ყველა API მეთოდი.

რა არის დათა?

მოთხოვნის მონაცემები, რომელსაც ასევე ჩვეულებრივ უწოდებენ "სხეულს", არის ინფორმაცია, რომელიც გაიგზავნება ან დაბრუნდება სერვერის მიერ. JSON-ის წინა განხილვაში შეგიძლიათ ნახოთ API მონაცემების მაგალითი. მოთხოვნის ძირითადი ნაწილი ზოგჯერ მოითხოვს კონკრეტულ ინფორმაციას მის მიწოდებამდე. ამის მაგალითია, თუ თქვენ არედაქტირებთ ერთ პროდუქტს, პროდუქტის ID იქნება საჭირო რაიმე ცვლილების შეტანამდე.

წაიკითხე მეტი აქ დაწკაპუნებით.