Enviar parte da mídia
PUT /v1/media/:id/parts/:part escopo write
Envia uma parte do arquivo (bytes crus no corpo). Reenviar a mesma parte é seguro. Toda parte, menos a última, precisa ter o mesmo tamanho (no mínimo 5 MiB).
Cabeçalhos
Authorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/midia/:id/partes/:n.
Parâmetros
| Nome | Onde | Descrição |
|---|---|---|
id |
caminho | Id da mídia. |
part |
caminho | Número da parte, de 1 a 10000. |
Corpo da requisição
Os bytes crus do arquivo (não é JSON), com o Content-Type do arquivo.
Exemplo
curl -X PUT "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1" \
-H "Authorization: Bearer $PRAEKO_KEY" \
-H "X-Praeko-Contract: en" \
-H "Content-Type: video/mp4" \
--data-binary @video.mp4const res = await fetch("https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1", {
method: "PUT",
headers: {
"Authorization": `Bearer ${process.env.PRAEKO_KEY}`,
"X-Praeko-Contract": "en",
"Content-Type": "video/mp4",
},
body: await (await import("node:fs/promises")).readFile("video.mp4"),
});
console.log(res.status, await res.json());// O @praeko/sdk ainda não tem um método para esta rota: use o fetch (aba JavaScript).
const res = await fetch("https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1", {
method: "PUT",
headers: {
"Authorization": `Bearer ${process.env.PRAEKO_KEY}`,
"X-Praeko-Contract": "en",
"Content-Type": "video/mp4",
},
body: await (await import("node:fs/promises")).readFile("video.mp4"),
});
console.log(res.status, await res.json());import os
import requests
resp = requests.put(
"https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1",
headers={
"Authorization": f"Bearer {os.environ['PRAEKO_KEY']}",
"X-Praeko-Contract": "en",
"Content-Type": "video/mp4",
},
data=open("video.mp4", "rb"),
)
print(resp.status_code, resp.json())<?php
$ch = curl_init('https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("PRAEKO_KEY"),
'X-Praeko-Contract: en',
'Content-Type: video/mp4',
],
CURLOPT_POSTFIELDS => file_get_contents("video.mp4"),
]);
$resposta = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), " ", $resposta, PHP_EOL;
curl_close($ch);package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
body, err := os.Open("video.mp4")
if err != nil {
panic(err)
}
defer body.Close()
req, err := http.NewRequest("PUT", "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("PRAEKO_KEY"))
req.Header.Set("X-Praeko-Contract", "en")
req.Header.Set("Content-Type", "video/mp4")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(resp.Status, string(out))
}require "net/http"
require "uri"
uri = URI("https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1")
request = Net::HTTP::Put.new(uri)
request["Authorization"] = "Bearer #{ENV['PRAEKO_KEY']}"
request["X-Praeko-Contract"] = "en"
request["Content-Type"] = "video/mp4"
request.body = File.binread("video.mp4")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.code, response.bodyusing System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Put, "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PRAEKO_KEY"));
request.Headers.Add("X-Praeko-Contract", "en");
request.Content = new StreamContent(File.OpenRead("video.mp4"));
request.Content.Headers.ContentType = new MediaTypeHeaderValue("video/mp4");
using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1"))
.header("Authorization", "Bearer " + System.getenv("PRAEKO_KEY"))
.header("X-Praeko-Contract", "en")
.header("Content-Type", "video/mp4")
.method("PUT", HttpRequest.BodyPublishers.ofFile(Path.of("video.mp4")))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}http PUT "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1" \
"Authorization: Bearer $PRAEKO_KEY" \
"X-Praeko-Contract: en" \
"Content-Type: video/mp4" \
< video.mp4Esta rota ainda não tem chamada própria no SDKO exemplo usa
fetch.Sem SDK oficialExemplo com a biblioteca padrão (ou o cliente HTTP) da linguagem. Só o SDK de JavaScript existe.
Sem SDK oficialExemplo com a biblioteca padrão (ou o cliente HTTP) da linguagem. Só o SDK de JavaScript existe.
Sem SDK oficialExemplo com a biblioteca padrão (ou o cliente HTTP) da linguagem. Só o SDK de JavaScript existe.
Sem SDK oficialExemplo com a biblioteca padrão (ou o cliente HTTP) da linguagem. Só o SDK de JavaScript existe.
Sem SDK oficialExemplo com a biblioteca padrão (ou o cliente HTTP) da linguagem. Só o SDK de JavaScript existe.
Sem SDK oficialExemplo com a biblioteca padrão (ou o cliente HTTP) da linguagem. Só o SDK de JavaScript existe.
Resposta
| Status de sucesso | Quando |
|---|---|
200 |
Sucesso. |
{
"id": "01KA3VQ7M2T9XE4HB8N5RZ6C0D",
"part": 1,
"size": 16777216,
"etag": "eb4fc1b20b020225bebfd48686d92517"
}Mande a mesma parte de novo para substituí-la.
Erros
Sem erros específicos desta rota além dos comuns.
Erros de qualquer rota
| Status | code | Quando |
|---|---|---|
| 401 | unauthorized |
Faltou o cabeçalho Authorization: Bearer …. |
| 401 | invalid_api_key |
A chave não existe. |
| 401 | revoked_api_key |
A chave foi revogada. |
| 401 | expired_api_key |
A chave expirou. |
| 403 | forbidden |
O escopo da chave não basta para esta rota (veja o selo de escopo). |
| 429 | rate_limited |
Passou do limite de requisições por minuto. |
O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.
Testar
Testar
Entre para testarO teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.
Dúvida ou erro nesta página? contato@praeko.appVer .md