Get Media Details

Retrieve metadata for a specific media item.

POST

/media/get/{mediaId}

Serverhttps://api.medialit.cloud

Authentication

Path parameters

Authentication

Bearer token (JWT)
Or API key in the x-medialit-apikey header

Parameters

path parameters

Name	Type	Description
`mediaId`required	`string`	ID of the media file

Responses

200

Media details retrieved successfully

mediaIdstring
required
originalFileNamestring
required
mimeTypestring
required
sizenumber (float)
required
accessstring
required
One of: "public", "private"
filestring
required
thumbnailstring
captionstring
groupstring

400

More than one credential was sent, for example both a Bearer token and an API key

errorstring
required

401

Unauthorized

errorstring
required

403

Forbidden

No response body.

404

Media not found

errorstring
required

500

Internal Server Error

errorstring
required

Request

curl -X POST 'https://api.medialit.cloud/media/get/{mediaId}' \
  -H 'Authorization: Bearer $API_TOKEN'

const response = await fetch("https://api.medialit.cloud/media/get/{mediaId}", {
  method: "POST",
  headers: {
    "Authorization": "Bearer $API_TOKEN",
  },
});
const data = await response.json();

import requests

response = requests.request(
    "POST",
    "https://api.medialit.cloud/media/get/{mediaId}",
    headers={
        "Authorization": "Bearer $API_TOKEN",
    },
)
data = response.json()

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.medialit.cloud/media/get/{mediaId}", nil)
	req.Header.Set("Authorization", "Bearer $API_TOKEN")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.medialit.cloud/media/get/{mediaId}"))
    .header("Authorization", "Bearer $API_TOKEN")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.medialit.cloud/media/get/{mediaId}");
request.Headers.Add("Authorization", "Bearer $API_TOKEN");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

{
  "mediaId": "string",
  "originalFileName": "string",
  "mimeType": "string",
  "size": 0,
  "access": "public",
  "file": "string",
  "thumbnail": "string",
  "caption": "string",
  "group": "string"
}

{
  "error": "credential_ambiguous",
  "error_description": "Exactly one credential mechanism is allowed."
}

{
  "error": "Unauthorized"
}

{
  "error": "Not Found"
}

{
  "error": "Internal Server Error"
}