Skip to main content
Questo documento presenterà un’istruzione per l’integrazione dell’API Short URL, che può convertire URL lunghi in URL brevi.

​
Processo di richiesta

Per utilizzare l’API Short URL, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e a effettuare il login; una volta completato, verrai automaticamente riportato alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta offre un credito gratuito, per un’esperienza senza costi; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: Short URL API →

​
Utilizzo di base

Prima di tutto, è importante comprendere il modo di utilizzo di base, che consiste nell’inserire l’URL lungo da convertire per ottenere il risultato elaborato; è necessario semplicemente passare un campo content. Possiamo quindi compilare il contenuto corrispondente nell’interfaccia, come mostrato nell’immagine:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta desiderata, qui impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • content: il contenuto dell’URL da accorciare.
Dopo aver selezionato, possiamo notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” possiamo effettuare un test; come mostrato nell’immagine sopra, abbiamo ottenuto il seguente risultato:
Il risultato restituito ha diversi campi, descritti come segue:
  • success, lo stato se il compito è stato completato con successo.
  • data, che contiene l’URL convertito.
Si può notare che l’URL lungo originale https://platform.acedata.cloud/documents/shorturl è stato convertito con successo nell’URL breve https://surl.id/1uHCs01xa5. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente:
Il codice di integrazione Python è il seguente:

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API Short URL per convertire URL lunghi in URL brevi. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.