HTTP API

Pastes aus deinen Projekten hochladen.

Für Java-Projekte, Bots und Automatisierung verwendest du am besten einen persönlichen API-Token. Mit Token erstellte Pastes landen automatisch unter deinem Account.

Bearer Token

Authentifizierung

Sende deinen Token im HTTP-Header Authorization. Der vollständige Token wird beim Erstellen nur einmal angezeigt und serverseitig ausschließlich gehasht gespeichert.

Authorization: Bearer mdp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Anmelden und Token erstellen

POST /api/paste

Feld	Werte	Pflicht
content	Textinhalt	ja
title	max. 120 Zeichen	nein
language	auto, plaintext, java, javascript, …	nein
expires	10m, 1h, 1d, 7d, 30d, never	nein
visibility	unlisted, public	nein
password	max. 128 Zeichen	nein

cURL

curl -X POST https://paste.minedevhd.net/api/paste \
  -H 'Authorization: Bearer mdp_DEIN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"title":"error.log","content":"Exception...","language":"plaintext","expires":"30d","visibility":"unlisted"}'

Java 8

URL url = new URL("https://paste.minedevhd.net/api/paste");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("POST");
con.setDoOutput(true);
con.setRequestProperty("Authorization", "Bearer " + apiToken);
con.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

String json = "{\"title\":\"error.log\"," +
        "\"content\":\"" + escape(log) + "\"," +
        "\"language\":\"plaintext\"," +
        "\"expires\":\"30d\"," +
        "\"visibility\":\"unlisted\"}";

try (OutputStream out = con.getOutputStream()) {
    out.write(json.getBytes(StandardCharsets.UTF_8));
}

Im ZIP liegt zusätzlich eine vollständige Java-8-Hilfsklasse unter examples/java8/MineDevHD.netPasteClient.java.

Antwort

{
  "ok": true,
  "slug": "Ab3kP9xQ",
  "url": "https://paste.minedevhd.net/Ab3kP9xQ",
  "raw_url": "https://paste.minedevhd.net/raw/Ab3kP9xQ",
  "download_url": "https://paste.minedevhd.net/download/Ab3kP9xQ",
  "manage_url": "https://paste.minedevhd.net/edit/Ab3kP9xQ",
  "owned_by_account": true,
  "auth_method": "token",
  "api_token_name": "Desktop-Client"
}

Wichtig: Einen persönlichen API-Token nicht fest in einer öffentlich verteilten JAR speichern. Bei Software, die nur auf deinen eigenen Systemen läuft, den Token bevorzugt aus einer Config-Datei oder Umgebungsvariable laden.