Come funziona

Ahrefs Connect consente alla tua app di accedere ai dati dell’API di Ahrefs per conto di un utente che collega il proprio account Ahrefs al tuo prodotto.

Ecco il flusso di base:

1. La tua app si integra con l’API di Ahrefs tramite OAuth.
2. Un utente in comune con un abbonamento Ahrefs a pagamento collega il proprio account alla tua app.
3. La tua app richiede i dati di Ahrefs per conto di quell’utente.
4. Ogni richiesta consuma unità API dalla quota mensile di quell’utente.
5. Elabori, memorizzi e visualizzi tali dati nella tua app per quell’utente.

Requisiti di idoneità

Per aderire ad Ahrefs Connect, la tua app deve:

• Essere un prodotto disponibile al pubblico con una base utenti già esistente. Se ti servono i dati di Ahrefs per uso personale o interno, dovresti invece utilizzare direttamente l’API di Ahrefs.
• Non competere direttamente con Ahrefs né copiare le nostre funzionalità.
• Richiedere dati solo per conto di singoli utenti Ahrefs con account a pagamento. Ahrefs Connect non è pensato per i prodotti che vogliono mostrare i dati di Ahrefs a un pubblico generico senza che ogni visualizzatore sia un utente Ahrefs.

Procedura

1. Applicazione

Invia il modulo di candidatura con:

• Una descrizione del tuo prodotto
• Un link al tuo sito web
• Dettagli su come prevedi di utilizzare i dati di Ahrefs nella tua app

Il nostro team Enterprise confermerà se il tuo prodotto è idoneo, spiegherà la procedura e fornirà assistenza.

2. Piano Enterprise

Se stai realizzando una nuova integrazione (non parte del programma legacy), avrai bisogno di un piano Ahrefs Enterprise per attivare l'integrazione in produzione.

• Non hai bisogno del piano durante lo sviluppo.
• È necessario per abilitare l’integrazione per gli utenti attivi.

Il nostro team commerciale ti guiderà in questo passaggio.

3. Sviluppo

Una volta completata la configurazione, troverai la sezione Ahrefs Connect nelle Impostazioni account. Questa pagina fornisce i dettagli per l’implementazione di OAuth:

• Client ID e client secret
• Campi per impostare i Redirect URI per gli ambienti di staging e produzione

In questa fase, lo stato della tua app sarà Inactive, il che ti consente di:

• Testare i flussi OAuth nel tuo ambiente di staging
• Effettuare richieste di test gratuite agli endpoint dell’API v3

Risorse:

• Documentazione API v3
• Richieste di test gratuite
• Guida all’implementazione di OAuth

Per qualsiasi domanda durante lo sviluppo, contatta [email protected] o il responsabile commerciale con cui sei stato in contatto.

4. Recensione

Quando lo sviluppo è completo, avvisa il nostro team di supporto o commerciale. Ti forniranno le istruzioni per l’invio e i dettagli sui requisiti di approvazione.

Ulteriori informazioni: Processo di approvazione

5. Attivazione

Una volta approvata, la tua app passa a Active. Questo abilita:

• Connessioni OAuth attive per gli utenti Ahrefs in produzione
• Accesso completo alle richieste API in produzione

Il nostro team commerciale può anche aggiungere la tua app alla Galleria delle app, così gli utenti possono trovarla facilmente. Questo richiede di fornire ulteriori dettagli per la scheda dell’app: guida alla Galleria app