Migrare le chiamate Trading API deprecate alle REST di eBay

La Trading API di eBay (XML, autenticazione Auth'n'Auth) è in manutenzione e alcune sue chiamate vengono decommissionate a scadenze precise. Continuare a dipenderne è un rischio: la direzione è chiara, le REST API. Questa guida mostra come mappare le chiamate deprecate e migrare per gradi senza fermare le vendite.

Perché migrare ora

eBay pubblica uno scadenzario di deprecazione: per esempio GetCategoryFeatures è destinata alla decommissione (maggio 2026) a favore della Taxonomy API. Le chiamate legacy smettono di funzionare a date fisse: meglio pianificare prima che dopo.

La mappa Trading → REST

Trading API (legacy)	REST equivalente
AddItem / ReviseItem	Inventory API (inventory item, offer, publish)
GetOrders	Fulfillment API
GetCategorySpecifics / GetCategoryFeatures	Taxonomy API
Movimenti e payout	Finances API

Per il modello SKU → inserzione fai riferimento alla guida sulla eBay Inventory API.

Autenticazione: da Auth'n'Auth a OAuth

La Trading usa i token Auth'n'Auth; le REST usano OAuth. Pianifica la transizione dei token e degli scope: è una parte della migrazione spesso sottovalutata.

Migrazione per gradi, non big bang

Migra un dominio alla volta — prima l'inventory, poi ordini e finances — mantenendo la coesistenza durante la transizione. È lo stesso approccio descritto nel confronto tra Sell API e Trading API. Per il lato acquirente (ricerca e catalogo) il discorso è separato: vedi la guida sulla eBay Browse API.

Errori comuni

• aspettare la data di decommissione invece di migrare con margine;
• riprodurre l'XML uno-a-uno invece di adottare il modello REST;
• dimenticare il passaggio da Auth'n'Auth a OAuth;
• doppie scritture non coordinate durante la coesistenza.

Conclusione

La Trading API non sparisce domani, ma le sue chiamate cadono a scadenze fisse: pianifica la migrazione per domini, gestisci OAuth e tieni la coesistenza sotto controllo. Riferimenti: stato di deprecazione e la guida di migrazione alla Taxonomy API.