Dokumentation for brug af MiniLink.dk's API

Base URL: https://minilink.dk/api/

Løsning 1: Via URL

Opret et mini link via URL-parametere. Dette er den simpleste metode til at forkorte links.

GETForkorte link via URL

https://minilink.dk/api/post/{url}

Bemærk: URL'en skal være URL-encoded.

https://minilink.dk/api/post/https%3A%2F%2Fsimonfas.dk

Løsning 2: GET/POST request med JS

Brug JavaScript fetch eller cURL til at lave API-kald med mere kontrol over data.

GETGET Request (browser/JS/fetch)

GET https://minilink.dk/api/post/https%3A%2F%2Fwww.simonfas.dk

POSTPOST Request (cURL)

curl -X POST https://minilink.dk/api/post \ -H "Content-Type: application/json" \ -d '{"url": "https://www.simonfas.dk"}'

Output

API'et returnerer JSON-data med information om det forkortede link.

Hvis linket allerede eksisterer modtager du:

{ "ok": "true", "message": "Metadata opdateret for eksisterende link", "slug": "GeEuG", "short": "https://mnlk.dk/GeEuG", "url": "https://simonfas.dk" }

Hvis det er et nyt link:

{ "ok": "true", "message": "Nyt link oprettet", "slug": "GeEuG", "short": "https://mnlk.dk/GeEuG", "url": "https://simonfas.dk" }

Hvis man sender et link uden HTTPS:

{ "ok": "false", "status": 400, "error_code": "HTTPS_REQUIRED", "error": "Kun HTTPS-links er tilladt" }

Hvis man sender et link uden TLD (Top Level Domain):

{ "ok": "false", "status": 400, "error_code": "INVALID_TLD", "error": "URL skal have et gyldigt domæne med TLD (fx .com, .dk, .eu osv.)" }

Hvis man sender et link der er blokeret af Minilink:

{ "ok": "false", "status": 400, "error_code": "DOMAIN_BLOCKED", "error": "Links fra domænet \"{Domæne_Her}\" er blokeret og kan ikke forkortes.", "host": "{Link_Her}" }

Hvis man sender et link der er vurderet usikker af VirusTotal:

{ "ok": "false", "status": 400, "error_code": "VIRUSTOTAL_BLOCK", "error": "Linket er markeret som usikkert af VirusTotal og kan ikke forkortes." "verdict": "blocked_by_virustotal" "stats": { "harmless" : {tal_her}, "malicious" : {tal_her}, "suspicious" : {tal_her}, "undetected" : {tal_her}, "timeout" : {tal_her} } }

Hvis man sender et link der er vurderet mistænktligt af Certstream:

{ "ok": "false", "status": 400, "error_code": "CERTSTREAM_BLOCK", "error": "Domænet \"{Domæne_Her}\" er markeret som mistænkeligt (CertStream) og kan ikke forkortes." "host": "{Domæne_Her}" "matched_rule": "keyword:xxx" "severity": {tal_her} }

Fejlhåndtering

Vigtige noter:
  • Links skal være gyldige og indeholde protokol (https://)
  • Links skal være gyldige og indeholde TLD (fx .com, .dk, .eu osv.)
  • Links skal være URL-encoded når de sendes via GET-parametere
  • API'et opdaterer metadata for eksisterende links ved genoprettelse

Rate Limiting

Der er ingen rate limits på nuværende tidspunkt, men vær venlig ikke at misbruge API'et. Automatiserede requests bør holdes på et rimeligt niveau.

Eksempel på JavaScript Implementation

const axios = require('axios'); async function createLink() { try { const response = await axios.post( "https://minilink.dk/api/post", { url: "https://www.simonfas.dk", } ); console.log(response.data); } catch (err) { console.log("Fejl:", err.response?.data || err.message); } } createLink();
← Tilbage til forsiden