# Enviar parte da mídia

> Enviar parte da mídia: PUT /v1/media/:id/parts/:part. 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).

Fonte: https://praeko.app/docs/api/media/upload-media-part

`PUT /v1/media/:id/parts/:part` · escopo mínimo: 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**

```bash
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.mp4
```

**JavaScript**

```js
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());
```

**Node**

```js
// 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());
```

**Python**

```python
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**

```php
<?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);
```

**Go**

```go
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))
}
```

**Ruby**

```ruby
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.body
```

**C#**

```csharp
using 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()}");
```

**Java**

```java
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());
    }
}
```

**HTTPie**

```bash
http PUT "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1" \
  "Authorization: Bearer $PRAEKO_KEY" \
  "X-Praeko-Contract: en" \
  "Content-Type: video/mp4" \
  < video.mp4
```

> Esta rota ainda não tem chamada própria no SDK: O exemplo usa `fetch`.

## Resposta

| Status de sucesso | Quando |
|---|---|
| `200` | Sucesso. |

**Resposta 200**

```json
{
  "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](https://praeko.app/docs/guides/errors-and-limits).

## Testar

> **Testar**: o teste ao vivo exige entrar na conta. Aqui ele fica desligado.