დღე 0
დაადასტურეთ წვდომა
შექმენით გასაღები, შეასრულეთ ერთი ავთენტიფიცირებული მოთხოვნა და შეინახეთ პირველი პასუხი მისი მეტამონაცემებით.
გახსენით ნაბიჯი →API სამუშაო პროცესის სახელმძღვანელო
შეარჩიეთ თქვენს სამუშაოსთან ყველაზე ახლოს მყოფი შედეგი. თითოეული გზა გაძლევთ ერთ სამუშაო მოთხოვნას, იმას თუ რას უნდა შეიცავდეს პასუხი, როგორ შეამოწმოთ მისი მუშაობა და შემდეგ სასარგებლო ნაბიჯს.
ხუთი პრაქტიკული გზა
არჩეული: მოიტანეთ მაკრო მონაცემები
თქვენი 14-დღიანი API სატესტო პერიოდი
მიზანი არ არის ყველა პროდუქტის გვერდზე სტუმრობა. მიზანია სასარგებლო ავთენტიფიცირებული API სამუშაოს შესრულება, სხვა დღეს დაბრუნება და წასვლა განმეორებადი მონაცემთა ნაკრებით ან აპლიკაციის სამუშაო პროცესით.
დღე 0
შექმენით გასაღები, შეასრულეთ ერთი ავთენტიფიცირებული მოთხოვნა და შეინახეთ პირველი პასუხი მისი მეტამონაცემებით.
გახსენით ნაბიჯი →დღეები 1-2
მოაგვარეთ ავთენტიფიკაციის ან ფილტრაციის პრობლემები და გადააქციეთ პირველი სკრიპტი დასახელებულ, განმეორებად დავალებად.
გახსენით ნაბიჯი →დღეები 3-4
გამოიყენეთ კალენდარი, როგორც მეორე endpoint-ების ოჯახი და დაგეგმეთ შემდეგი სასარგებლო API გაშვება.
გახსენით ნაბიჯი →დღეები 5-7
დაამატეთ მოლოდინები ან მაკრო სერიების მცირე ჯგუფი, შემდეგ შექმენით ერთი შენახული შედარება, ცხრილი ან სქორქარდი.
გახსენით ნაბიჯი →დღეები 8-10
შეარჩიეთ დაგეგმილი REST, SSE, ან webhooks და დაასრულეთ კიდევ ერთი წარმატებული API გაშვება სხვა დღეს.
გახსენით ნაბიჯი →დღეები 11-13
დაამატეთ თაიმაუტები, შეზღუდული თავდახელებები (retries), პასუხის ვალიდაცია, მონაცემთა უსაფრთხოな ლოგირება და მოძველებული მონაცემების მონიტორინგი.
გახსენით ნაბიჯი →დღე 14
დაადასტურეთ, რომ API უზრუნველყოფს განმეორებად სამუშაოს, რომელსაც თქვენი გუნდი გააგრძელებს, შემდეგ კი აირჩიეთ შემდეგი მონაცემთა ნაკრები ან აპლიკაციის სამუშაო პროცესი.
გახსენით ნაბიჯი →პირველი მოთხოვნა
დაიწყეთ ერთი ვალუტით და ინდიკატორით, რომელიც უკვე გესმით. ეს ამარტივებს ავთენტიფიკაციის, პასუხის ფორმის, პაგინაციის და შენახვის შემოწმებას მანამ, სანამ მეტ სერიას დაამატებთ.
სამუშაო მაგალითი
შეინახეთ თქვენი გასაღები FXMD_API_KEY; არასოდეს ჩასვათ იგი წყაროს კონტროლში (source control).
import os
import requests
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])
მოსალოდნელი შედეგი: 200 პასუხი ბოლო EUR ინფლაციის დაკვირვებებით, პლუს პასუხის მეტამონაცემები, რომლებიც აღწერს მწკრივს, წყაროს, გვერდგადასხვას და მონაცემთა ხარისხს.
როდესაც პირველი სკრიპტი ხდება რეალური სისტემა
გამოიყენეთ ეს სახელმძღვანელოები, როდესაც პასუხი ვერ მიიღება, არ აბრუნებს მონაცემებს ან საჭიროებს პროდუქციულ კონტროლს, როგორიცაა ქეშირება, თაუტიმები, ხელახალი მცდელობები და მოვლენების მიწოდება.
| გზამკვლევი | გამოიყენეთ მაშინ, როცა | დაწყება |
|---|---|---|
| წარუმატებელი ან ცარიელი პასუხის დიაგნოსტიკა | ავთენტიფიკაციის, წვდომის, გზის, rate-limit-ისა და მონაცემთა ხელმისაწვდომობის ცალკეული პრობლემების გარკვევა თქვენი გასაღების გამჟღავნების გარეშე. | გახსენით გზამკვლევი → |
| გახადეთ API კლიენტი საწარმოო მზადყოფნისთვის | დაამატეთ ტაიმაუტები, შეზღუდული თავეupები, ქეშირება, პირობითი მოთხოვნები და სწორი მიწოდების მოდელი. | გახსენით გზამკვლევი → |