Accedi alle API di CommerceClarity tramite Bearer Token
Le API di CommerceClarity utilizzano l'autenticazione Bearer Token per proteggere gli endpoint e garantire che solo i client autorizzati possano accedere ai dati. Ogni richiesta API deve includere un token di accesso valido nell'header HTTP.
Attualmente, i token API vengono forniti direttamente dal team di supporto di CommerceClarity. Per richiedere un token di accesso, compila il modulo di supporto disponibile a questo link fornendo il nome della tua organizzazione e la richiesta del token api nella descrizione.
Per autenticare le tue richieste API, includi il token nel header Authorization
di ogni richiesta HTTP usando il formato Bearer <token>
.
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
curl -X GET "https://api.commerceclarity.io/products/list" \
-H "Authorization: Bearer IL_TUO_TOKEN_API" \
-H "Accept: application/json"
<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
$client = new Client([
'base_uri' => 'https://api.commerceclarity.io',
'timeout' => 10.0,
'headers' => [
'Authorization' => 'Bearer IL_TUO_TOKEN_API',
'Accept' => 'application/json',
]
]);
try {
$response = $client->get('/products/list');
$data = json_decode($response->getBody()->getContents(), true);
// Elabora i dati
} catch (RequestException $e) {
if ($e->hasResponse()) {
$errorResponse = json_decode($e->getResponse()->getBody()->getContents(), true);
// Gestisci l'errore...
}
}
const apiUrl = 'https://api.commerceclarity.io/products/list';
const token = 'IL_TUO_TOKEN_API';
fetch(apiUrl, {
method: 'GET',
headers: {
'Authorization': `Bearer ${token}`,
'Accept': 'application/json'
}
})
.then(response => {
if (!response.ok) {
throw new Error(`Status: ${response.status}`);
}
return response.json();
})
.then(data => {
console.log('Dati ricevuti:', data);
// Elabora i dati
})
.catch(error => {
console.error('Errore durante la richiesta API:', error);
});
import requests
api_url = 'https://api.commerceclarity.io/products/list'
token = 'IL_TUO_TOKEN_API'
headers = {
'Authorization': f'Bearer {token}',
'Accept': 'application/json'
}
try:
response = requests.get(api_url, headers=headers)
response.raise_for_status() # Solleva un'eccezione per risposte HTTP 4XX/5XX
data = response.json()
# Elabora i dati
except requests.exceptions.HTTPError as err:
print(f'Errore HTTP: {err}')
if response.text:
error_data = response.json()
print(f'Messaggio di errore: {error_data.get("message", "Nessun messaggio")}')
except requests.exceptions.RequestException as err:
print(f'Errore durante la richiesta: {err}')
Se il token è mancante o non valido la richiesta API riceverà una risposta di errore 401 Unauthorized
.
{
"status": "error",
"message": "Unauthenticated."
}
Il tuo token API fornisce accesso completo al tuo account CommerceClarity. Per proteggere i tuoi dati:
Utilizza sempre HTTPS per le richieste API per garantire che il token e tutti i dati trasmessi siano crittografati durante il transito.
Evita di includere i token API nelle applicazioni frontend JavaScript accessibili pubblicamente. Utilizza invece un server backend per effettuare le richieste API.
Problema | Possibile Causa | Soluzione |
---|---|---|
"Unauthenticated" o errore 401 | Token mancante o non valido | Verifica che il token sia correttamente formattato e incluso nell'header <code>Authorization</code> |
Il token funziona per alcuni endpoint ma non per altri | Il token potrebbe avere permessi limitati o specifici | Verifica la documentazione per requisiti specifici di autenticazione per gli endpoint in questione |
Aggiungi nuovi prodotti al tuo inventario per poterne recuperare i dettagli.
Vai ad Analisi ProdottiVerifica lo stato attuale di un prodotto specifico nel tuo inventario.
Vai a Dettagli ProdottoSe hai domande o riscontri problemi con le API, il nostro team di supporto è a tua disposizione. Compila il modulo di supporto disponibile a questo link includendo dettagli sulla richiesta e qualsiasi messaggio di errore ricevuto.