Sviluppatori

L'API pubblica di ControlResell

Automatizzate la vostra attività con i vostri script e strumenti: leggete account, articoli e conversazioni con una chiave API.

L'API pubblica è in fase di rilascio. È riservata agli abbonamenti che la includono e viene aperta gradualmente: la pagina di gestione delle chiavi non è ancora visibile su tutti gli account. Senza accesso, l'API risponde con un errore 402.

Generare la chiave API

Le chiavi si creano nell'app, con la vostra sessione. Una chiave non può creare, elencare o revocare un'altra chiave.

  1. Accedete all'app web di ControlResell.
  2. Aprite Impostazioni, poi Sviluppatori.
  3. Create una chiave: assegnatele un nome, selezionate almeno un ambito e, se volete, una data di scadenza (al massimo 5 anni).
  4. Copiate subito il segreto: viene mostrato una sola volta.

Gestisci le mie chiavi API

Il segreto inizia con cr_live_. Trattatelo come una password: ControlResell ne conserva solo un'impronta e non può mostrarlo di nuovo. In caso di dubbio, revocate la chiave e createne un'altra.

Inviate la chiave nell'intestazione Authorization di ogni chiamata. Esempio per leggere il vostro profilo:

curl https://api.controlresell.com/api/public/v1/me \
  -H "Authorization: Bearer cr_live_..."

Potete avere al massimo 10 chiavi attive, ciascuna revocabile in qualsiasi momento.

Ambiti disponibili

  • accounts:read – Lettura degli account marketplace
  • items:read – Lettura degli articoli e dei relativi annunci
  • items:write – Scrittura degli articoli
  • orders:read – Lettura degli ordini
  • conversations:read – Lettura delle conversazioni
  • conversations:write – Scrittura delle conversazioni

Documentazione dell'API

Il riferimento interattivo (Swagger) e la specifica OpenAPI sono pubblici e generati dall'API in produzione.

L'API è versionata (/api/public/v1). La v1 evolve solo per aggiunte; in caso di rottura si apre una v2 e la v1 resta disponibile per almeno dodici mesi dopo l'annuncio.

SDK e CLI ufficiali

SDK generati dalla specifica e una CLI, open source su GitHub.

I pacchetti non sono ancora pubblicati: presto su npm, PyPI e Maven Central. Nel frattempo il codice sorgente è disponibile su GitHub.