Feeduri de produse sau API: ce integrare construiești pentru afiliere?

Începe cu ce este autorizat

Prima întrebare nu este tehnică. Citește documentația și termenii rețelei pentru tipul tău de cont și întreabă rețeaua când ai dubii. Un endpoint care răspunde nu este neapărat unul susținut sau permis. Pentru o rețea citim cataloagele exclusiv din fișierele oficiale de feed, iar o protecție din cod refuză orice altă adresă de pe serverele acelei rețele, verificată din nou la fiecare redirecționare, ca o greșeală de configurare să nu poată trimite o cerere interzisă.

Lecția: construiește fiecare sursă în spatele unui adaptor, ca să poți trece de la API la feed (sau invers) fără să atingi restul aplicației.

Cum se compară cele două variante

• Actualitate. API-urile pot fi interogate la cerere; feedurile sunt instantanee, actualizate după programul rețelei. Pentru un catalog actualizat noaptea, feedul este de obicei suficient.
• Viteză. Un fișier mare poate fi mult mai rapid decât mii de cereri paginate: pentru un magazin, importul nostru a scăzut de la circa 40 de minute prin API la circa 3 minute din fișier.
• Completitudine. Feedurile conțin uneori câmpuri pe care API-ul nu le are (sau invers): exportul unei rețele oferă stocul real, poze suplimentare și coduri de bare.
• Formate. Variantele XML și CSV diferă de la o rețea la alta și de la un magazin la altul: escaparea caracterelor, separatorii de categorie, brandurile goale.
• Cache. Unele rețele păstrează în cache un format ore întregi, iar alt format al aceluiași feed este generat la fiecare cerere.
• Limite. API-urile au limite de cereri și tokeni de reînnoit; feedurile au limite de mărime și de timp de descărcare.

Proiectează pentru date imperfecte

Indiferent de sursă, pregătește-te pentru fișiere care își schimbă forma. Fișierul unui magazin s-a schimbat peste noapte: brandurile au devenit „Black Friday”, codurile de bare au devenit nume de departamente, iar separatorii de categorie nu mai erau escapați. Fără protecții, peste 130.000 de produse ar fi fost recreate cu identități noi. Acum considerăm un cod de bare real doar dacă are între 8 și 14 cifre, păstrăm o ofertă cunoscută pe produsul ei când titlul nu s-a schimbat, iar produsele afectate au fost restaurate din copia de siguranță de dimineață chiar în aceeași seară.

Alte protecții utile: o limită de creștere care oprește un val neobișnuit de produse noi până la aprobare, un procent minim din ofertele recente ale magazinului înainte ca un fișier parțial să înlocuiască datele vechi și reguli de actualitate care ascund ofertele neconfirmate de nicio sursă câteva zile.

O recomandare practică

Pentru un catalog actualizat zilnic, preferă fișierele oficiale de feed ale rețelei acolo unde există, citește-le o singură dată pe rulare, împarte-le pe programe și validează-le înainte de folosire. Folosește API-uri pentru ce nu pot oferi fișierele, atunci când rețeaua le documentează și le permite. În ambele cazuri, notează ce a făcut fiecare rulare și trimite alerte la orice neobișnuit.