Kredentzialak eta segurtasuna
Gida honek sk_test_ eta sk_live_ tokenak deskribatzen ditu. Demo publikoak sk_demo_ erabiltzen du, 24 ordutan iraungitzen da eta bere mugak eta aldi baterako biltegiratzea ditu.
Erabili tokena
SERTEC PESAGEren laguntza-zerbitzuak tokena ematen du. Sartu /api/v1-erako eskaera guztietan:
Kodea
Erabili HTTPS, TLS 1.2 edo berriagoarekin, eta bidali tokena goiburu horretan soilik. Opakua da: ez deskodetu eta ez sortu JWT bat. sk_test_ garapen-ingurunea da eta sk_live_ produkzioa, bide berberekin eta dokumentu bereiziekin.
Kodea
Baimendutako IPak
Tokenak baimendutako IPen zerrenda badu, eskaerak irteerako IP publiko horietako batetik etorri behar du. Baimendu gabeko IP batetik bidalitako baliozko tokenak 403 jasotzen du. Zerrenda hutsak edozein IP baimentzen du. Murrizketak tokenaren eta baimendutako zerbitzarien babesa osatzen du.
APIak ez du IPak erregistratzeko aukerarik. X-Forwarded-For bidaltzeak ez du helbiderik baimentzen. Jarri laguntza-zerbitzuarekin harremanetan irteerako IPa aldatu aurretik.
Babestu kredentzialak
- Gorde tokenak sekretuen kudeatzailean edo zerbitzariaren konfigurazio babestuan.
- Egin deiak zerbitzaritik; ez erakutsi tokena web-orrietan, nabigatzaileko JavaScript-ean edo hirugarrenei banatutako aplikazioetan.
- Ez sartu tokenak URLetan, biltegietan, logetan, pantaila-argazkietan edo laguntza-txarteletan.
- Erabili kredentzial independentea integrazio bakoitzerako.
- Filtraziorik susmatzen baduzu, eskatu baliogabetzea eta token berria.
QRaren URLak beste sekretu bat dauka. Erabili itzulitako esteka aldatu gabe eta ez argitaratu edo erregistratu. QR sarbideak sekretu hori erabiltzen du, Bearerrik eta APIaren IP murrizketarik gabe.
Mugak eta berriz saiatzeak
Token bakoitzak 60 eskaera minutuko onartzen ditu. QR deskargak 30 eskaera minutuko onartzen ditu IP eta dokumentu bererako. 429 jasotzean, itxaron Retry-After eremuko segundoak.
Eskaera-gorputzaren muga 128 KiB da. Bidali JSONa Content-Type: application/json erabiliz; beste formatu batek 415 itzultzen du eta gaizki eratutako JSONak, 400.
Erreferentziek bertsioak identifikatzen dituzte eta bakarrak dira erakundearen eta ingurunearen barruan. Sorrera bera erreferentzia eta datu berberekin errepikatzeak jatorrizko dokumentua itzultzen du 24 orduz. Erreferentziarik gabe, sorrera bakoitzak dokumentu berria jaulkitzen du. Zuzenketek datu guztiak berriz bidaltzea eta, adierazten bada, erreferentzia berria behar dute. Jatorrizkoa eta haren QRa gordetzen dira.
Bearer bidezko kontsultak eta deskargak kredentzial horrek azken 24 orduetan jaulkitako dokumentuetara mugatzen dira. QRak funtzionatzen jarraitzen du PDFa gordetzen den bitartean, epea igarota eta tokena biratu edo baliogabetu ondoren. Ezabatutako dokumentuak ezin dira deskargatu. Ezabatze logikoa 2 orduko epean soilik onartzen da, dokumentua entregatu edo erabili aurretik; lehen baliozko QR sarbideak ere blokeatzen du, 409 DOCUMENT_ALREADY_ACCESSED errorearekin. QR sarbideak, berez, ez du frogatzen garraioa egin denik.
Hedapenak Laravel-en planifikatzailea exekutatu behar du. Orduroko documents:prune-recent-keys atazak iraungitako azken sarbideko gakoak ezabatzen ditu; APIak 24 orduko muga aplikatzen du garbiketa oraindik exekutatu ez bada ere.
Atariko kontua eta berreskuratzea
Berreskuratze-kodea atariko kontu bati dagokio; ez da API token bat, eta ez da Bearer goiburuan bidaltzen. Altak, administratzaile gehigarriak barne, lehen passkeya konfiguratzea, kodea inprimatzea edo deskargatzea eta berriro sartzea eskatzen du kontua sortu aurretik. DeCAk ez du gordetako kodea berriro erakusten.
Passkeyak huts egiten badu, modal batek kodea sartzeko aukera ematen du. Saioa hasteko pasahitz zuzena behar da oraindik; kodeak passkeya ordezten du eta artxibo zifratuaren gako berak irekitzen ditu. Uneko pasahitza eskatzen duten eragiketek hura eskatzen jarraitzen dute. Bertan behera uzteak aurreko inprimakira itzultzen du, eragiketa gauzatu gabe.
Kodeak passkey bat eskatzen duen edozein eragiketa baimendu dezake, bere berritzea eta passkeyak ezabatzea barne. Passkey bat beste bat ezabatzeko erabiltzen bada, ezabatutakoaren desberdina izan behar du; erabiltzaile bakoitzak gutxienez passkey bat gordetzen du beti. Segurtasuna atalean, aurreko kodeak aktibo jarraitzen du berria inprimatu edo deskargatu eta behar bezala berriro sartu arte; orduan baliogabetzen da, zain dauden baieztapenekin batera.
Gorde kodea sistematik kanpo, leku pribatu batean eta pasahitzetik bereizita. Ez sartu API deietan, erregistroetan edo laguntzarako mezuetan. Gakoak ireki ditzaketen kredentzialak galtzeak artxiboa berreskuratzea eragotz dezake.
Kontserbazioa eta kopia pribatuak
PDFak urtebetez gordetzen dira, eta egituratutako datu zifratuak lau urtez, jaulkipenetik edo garraio-datatik, azken hori geroagokoa bada. Bearer sarbidea 24 ordura mugatuta dago oraindik. QRak konturik gabeko sarbidea ematen du PDFa gordetzen den bitartean; tokena aldatzeak edo baliogabetzeak ez du berez QR sarbidea kentzen. PDFa kendutakoan, QR zaharrak ez du hura deskargatzeko aukerarik ematen.
Datuak gordetzen diren bitartean, baimendutako pertsona batek atariko artxiboa desblokeatu eta PDFaren kopia pribatu bat sor dezake. Berriro sortzen da: ez ditu ezabatutako jatorrizko fitxategiaren byteak berreskuratzen, ez da PDF iraunkor berri gisa gordetzen eta ez du iraungitako QR esteka berraktibatzen. Jaulkipeneko hizkuntza eta logoa mantentzen dira jatorrizko datuetan badaude.
Zifratzeak ez du esan nahi zerbitzariak inoiz gakorik erabiltzen ez duenik: berreskuratze-kodearen egiaztapenak eta kopia pribatuaren sorrerak aldi baterako gako-materiala erabiltzen dute. Ez dira kodea testu arruntean edo berriro sortzeko jasotako datu-gakoa modu iraunkorrean gordetzen.
Hostinger-en kopiak 7 egunez gordetzen dira. Proiektuaren eskuzko kopiak ZIP formatuan eta datu-basearenak SQL formatuan ere egin daitezke: gorde sarbide publikotik kanpo, babestuta eta sarbide mugatuarekin. Azken 24 orduetako aldi baterako gakoen biltegi pribatua proiektutik eta datu-basetik bereizita dago, eta ZIP eta SQL horietatik kanpo geratu behar du. Berrezarri ondoren, exekutatu garbiketa kontserbazio-epeen arabera eta baliogabetu saioak eta aldi baterako sarbideak zerbitzua berriro ireki aurretik. Kopiek ez dute mugagabeko kontserbazioa baimentzen.
Garraio-datuak eta esparrua
Espainia barruko errepideko salgaien garraiorako, FOM/2861/2012 Aginduak datu hauek eskatzen ditu: kontratuzko kargatzailearen izena, IFZa eta helbidea; benetako garraiolariaren izena eta IFZa; karga- eta deskarga-lekuak; salgaien izaera eta pisua, edo beste magnitude bat pisua zehaztea zaila bada; garraio-data, ibilgailuaren eta atoiaren matrikulak eta beharrezko zirkulazio-baimen berezia.
origin.place eta destination.place eremuek instalazioa izenaren edo helbidearen bidez identifika dezakete. city eta country eremuekin benetako lekua argi identifikatu behar dute; aukerako street eta postal_code eremuek zehaztasuna ematen dute. Aginduak ez du hartzailearen identitate osoa eskatzen. carrier.address aukerakoa da; bidaltzen bada, Address eremu guztiak bete behar ditu. Adierazi benetako data, salgaien datu zuzenak eta atoia, badago.
Operadoreek gutxienez urtebetez gorde eta eskuragarri eduki behar dute, gainerako parte-hartzaileen sarbidea barne. PDFa sortzeak ez dakar eFTI ziurtagiririk eta ez ditu nazioarteko CMRa, ADRa, hondakin-garraioko dokumentuak edo animalia-azpiproduktuen dokumentuak ordezkatzen. Administrazio-kontrolerako dokumentu honek, oro har, ez du sinadura elektronikorik behar; bestelako kontratu-erabilerek sinadura egokia eska dezakete.
Konpondu sarbide-arazoak
| Erantzuna | Egiaztapena |
|---|---|
401 | Tokena falta da, okerra da edo baliogabetuta dago. Egiaztatu goiburua eta jarri laguntza-zerbitzuarekin harremanetan ordezkatzeko. |
403 | Egiaztatu irteerako IP publikoa eta eskatu baimena. Onartu gabeko eragiketa ere adieraz dezake. |
Laguntza-zerbitzuarekin harremanetan jartzean, eman ordua, irteerako IP publikoa, metodoa, bidea eta errore-kodea. Ez bidali inoiz tokena edo QRaren esteka sekretua.
Eskakizun elektronikoak: 2026ko ekainaren 5eko Ebazpena. PDF elektronikoak gehienez 5 MB ditu, sorrera- eta aldaketa-metadatuak eta zuzeneko HTTPS sarbidea. APIa erabiltzeak ez ditu parte-hartzaileen betebehar operatiboak ordezkatzen.
Zortzi hizkuntzek PDFaren izenburuak eta etiketak itzultzen dituzte, ez integrazioak bidalitako izenak, helbideak, oharrak edo beste datuak. Inprimatutako testuek letra-tipoek onartutako karaktere latindarrak, grekoak eta zirilikoak onartzen dituzte; emojiek, CJK karaktereek eta eskuinetik ezkerrerako idazkerek 422 UNSUPPORTED_CHARACTERS itzultzen dute dagokion eremuan. metadata eremuak edozein Unicode gordetzen du eta ez da inprimatzen.
Dokumentuen URLek zerbitzu-operadoreak konfiguratutako HTTPS URL publikoa erabiltzen dute. Baliogabea bada, 503 SERVICE_UNAVAILABLE itzultzen da; huts egindako jaulkipenak ez du dokumentu partzialik gordetzen.
Espainiako K, L eta M IFZ berezien formatua baliozkotzen da; DNI, NIE eta erakundeen IFZetan kontrol-karakterea ere egiaztatzen da. Identifikatzailea baliozkotzeak ez du existentzia edo erroldako alta frogatzen.