Skip to main content
Denna artikel kommer att introducera en integrationsbeskrivning för Kort URL API, som kan omvandla längre URL:er till kortare URL:er.

​
Ansökningsprocess

För att använda Kort URL API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du ska spara. Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan som bjuder in dig att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla plattformens tjänster, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; om kvoten tar slut kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: Kort URL API →

​
Grundläggande användning

Först bör du förstå den grundläggande användningen, vilket innebär att du anger den längre URL som behöver omvandlas, så får du det bearbetade resultatet. Du behöver först enkelt skicka ett content-fält. Vi kan sedan fylla i motsvarande innehåll på gränssnittet, som visas i bilden:

Här kan vi se att vi har ställt in Request Headers, inklusive:
  • accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga JSON-format.
  • authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.
Dessutom har vi ställt in Request Body, inklusive:
  • content: innehållet av URL:en som ska förkortas.
När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på “Try” knappen för att testa, som visas i bilden ovan, här har vi fått följande resultat:
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • success, status för om uppgiften lyckades.
  • data, som innehåller den omvandlade URL:en.
Det kan ses att den ursprungliga längre URL:en https://platform.acedata.cloud/documents/shorturl har framgångsrikt omvandlats till den korta URL:en https://surl.id/1uHCs01xa5. Om du vill generera motsvarande integrationskod kan du enkelt kopiera den som genererats, till exempel CURL-koden nedan:
Python-integrationskoden ser ut så här:

​
Felhantering

När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Unauthorized, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Intern serverfel, något gick fel på servern.

​
Exempel på felrespons

​
Slutsats

Genom detta dokument har du fått en förståelse för hur du använder Kort URL API för att omvandla längre URL:er till kortare URL:er. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.