Gida honek Akisplataforma APIra nola konektatu azaltzen du pausoz pauso, zer kredentzial behar dituzun eta kontsultak nola egin behar diren. Konexio-fluxua OAuth 2.0 estandarrean oinarritzen da, hau da, lehenik sarbide-token bat lortu eta gero token hori erabili behar duzu datuetara sartzeko.
Zer behar dut APIra konektatzeko?
APIa erabiltzeko, kredentzial pertsonalak behar dituzu.
- Kredentzial hauek webguneko erabiltzaile-eremuan daude eskuragarri.
- "API" atalean erabili behar duzun informazioa aurkituko duzu:
- erabiltzaile-izena : APIrako erabiltzaile IDa (zure erabiltzaile-kontuaren API eremuan aurkituko duzu).
- pasahitza : webgunean saioa hasteko erabiltzen duzun pasahitz bera da.
- client_id : API konexioaren identifikatzailea (zure erabiltzaile-kontuaren API eremuan aurkituko duzu).
Nola hasi saioa?
Orain zure kredentzialak dituzunez, konektatu zaitezke. Konexioak OAuth 2.0 estandarra jarraitzen du, eta bi urratseko prozesu batek bereizten du:
- 1. urratsa: Sarbide-token bat eskatu (autentifikazioa).
- 2. urratsa: Kontsumitu APIa token hori (datu-kontsulta) erabiliz.
Hau programazio bidez egin dezakezu (JavaScript, Python, PHP, etab.) edo Postman bezalako tresna bat erabiliz. (Irudi ereduak erantsi ditugu Postman erabiliz eskaera batean.)
1. urratsa: Sarbide-token bat eskatu
POST eskaera bat egin behar duzu URL honetara: https://akisplataforma.es/oauth/token eskaeraren gorputzean honako edukia jarriz ( application/json formatuan):{"grant_type": "password","client_id": "TU_CLIENT_ID_API","username": "TU_EMAIL_API","password": "TU_CONTRASEÑA"}
Hurrengo irudiak eskaera nola egin eta espero den erantzuna erakusten du, erantzunaren zati garrantzitsuena access_token da:
2. urratsa: Datuen kontsulta egin
Orain zure tokena duzula, egin bigarren eskaera bat https://akisplataforma.es/api-documentacion helbidean argitaratutako API amaierako puntuetako edozein kontsumitzeko; adibidez, albisteei buruzko datuak lortzeko, get metodoa erabiliz kontsulta bat egin beharko genuke https://akisplataforma.es/api/news amaierako puntura , aurretik lortutako tokena erabiliz.
