Rana 0
Shaidawa damar shiga
Ƙirƙiri mabuɗin, kammala buƙata ɗaya da aka tantance, sannan a ajiye amsar farko tare da bayananananta.
Buɗe mataki →jagorar tsarin aikin API
Me kake son ginawa?
Zaɓi sakamakon da ya fi kusa da aikinka. Kowane hanya yana ba ka buƙata ɗaya mai aiki, abin da amsar ya kamata ta ƙunsa, yadda za a duba ko ya yi aiki, da mataki na gaba mai amfani.
Hanyoyi biyar na aikace
Fara da sakamakon, ba da jerin endpoint ba.
Selected: Harden a client
Hanya 1
Samo bayanan macro
Kwashe jerin lokuta masu tsafta sannan ka ajiye bayanan tushe da inganci a gefensa.
Hanya 2
Tsara ayyukan fitarwa
Yi amfani da kalandar fitarwa don gudanar da ayyuka da aka takaita a lokutan wallafa da aka sani.
Hanya 3
Auna mamaki
Haɗa hasashen kafin fitarwa da darajar da aka wallafa ba tare da shigar da kuskuren kallon gaba ba.
Hanya 4
Sami sabuntawa na kai tsaye
Yi amfani da SSE a matsayin alamar rashin inganci, sannan ka ɗauko cikakken bayani daga REST.
Hanya 5
Gina samfurin macro
Maida ƙaramin rukuni na alamun da suka shafi juna zuwa scorecard na kuɗi mai lakabin tushe.
Gwaji na 14-kwanaki na API
Koma daga buƙata ta farko zuwa aikin da ya cancanci a ci gaba da shi.
Manufar ba ziyartar kowane shafin samfurin ba ne. Manufar ita ce kammala aikin API mai amfani da aka tantance, komawa a wani ranar, sannan a tashi da bayanan da za a iya maimaitawa ko tsarin aiki na aikace-aikace.
Kwanaki 1-2
Sanya buƙatar ta zama mai dogaro
Gyara matsalolin tantancewa ko tacewa sannan ka mayar da rubutun farko ya zama aiki mai suna wanda za a iya maimaitawa.
Buɗe mataki →Kwanaki 3-4
Ƙara lokacin saki
Yi amfani da kalandar a matsayin dangin endpoint na biyu kuma tsara na gaba mai amfani na gudanarwar API.
Buɗe mataki →Kwanaki 5-7
Gina sakamakon bincike
Ƙara ra'ayoyi ko ƙaramin rukunin jerin macro, sannan samar da kwatanci ɗaya da aka adana, tebur, ko scorecard.
Buɗe mataki →Kwanaki 8-10
Sanya sabuntawa ta atomatik
Zaɓi REST, SSE, ko webhooks da aka tsara kuma kammala wani nasarar gudanarwa na API a wani ranar daban.
Buɗe mataki →Kwanaki 11-13
Karfafa client din
Ƙara lokacin jira, sake gwaji mai iyaka, tantance amsa, logging mai tsaron credential, da sa ido kan tsohon bayani.
Buɗe mataki →Rana 14
Bita shaidar
Tabbatar da cewa API yana samar da aiki mai maimaitawa wanda tawagarka za ta ci gaba da shi, sannan ka zaɓi bayanan gaba ko aikin application.
Buɗe mataki →Production readiness
Sanya client na API ya zama shirye don samarwa
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Misali mai aiki
Ajiye mabuɗinka a FXMD_API_KEY; kada ka taɓa manna shi a cikin sarrafa tushe.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Sakamakon da ake tsamara: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
Lokacin da script na farko ya zama tsarin gaske
Gyaran matsaloli da jagorar samarwa
Yi amfani da waɗannan jagororin lokacin da amsa ta gaza, ba ta da bayani, ko take buƙatar sarrafa production kamar caching, timeouts, sake gwadawa, da isar da tura sakon
| Jagora | Yi amfani da shi lokacin da | Fara |
|---|---|---|
| Gano matsalar amsa da ta gaza ko kuma wadda take kyakkyawa | Raba matsalolin tantancewa, shiga, hanya, iyakar sauri, da samun bayanan ba tare da bayyana mabuɗinka ba. | Bude jagora → |
| Sanya client na API ya zama shirye don samarwa | Ƙara timeouts, sake gwadawa masu iyaka, caching, buƙatu na conditional, da tsarin isarwa mai kyau. | Bude jagora → |