Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Canais/Salvar horários do canal

Salvar horários do canal

PUT /v1/channels/:network/slots escopo write

Troca todos os horários semanais de um canal e reorganiza o que está na fila (channel escolhe a conta).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/canais/:rede/vagas.

Parâmetros

Nome Onde Descrição
network caminho Rede: youtube, instagram ou tiktok.
channel consulta Id da conta quando a rede tem várias (de GET /v1/channels). Sem ele, o canal padrão.

Corpo da requisição

JSON. Campos obrigatórios precisam ir; os outros podem ser omitidos.

Campo Tipo Descrição
timezone (opcional) texto Fuso horário IANA do canal. Sem ele, mantém o atual. Até 64 caracteres.
slots obrigatório string|object[] Os horários semanais (substituem TODOS os atuais; no máximo 100). Cada um é um texto "fri 17:30" ou um objeto { "day": "fri", "time": "17:30" }. Dias: sun, mon, tue, wed, thu, fri, sat (ou weekday de 0 a 6). Hora: HH:MM de 00:00 a 23:59. Repetidos viram um só. Até 100 itens.
Exemplo de corpo
{
  "timezone": "America/Sao_Paulo",
  "slots": [
    "mon 12:00",
    "fri 17:30",
    {
      "day": "sun",
      "time": "22:00"
    }
  ]
}

Exemplo

curl -X PUT "https://praeko.app/v1/channels/youtube/slots" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en" \
  -H "Content-Type: application/json" \
  -d '{
  "timezone": "America/Sao_Paulo",
  "slots": [
    "mon 12:00",
    "fri 17:30",
    {
      "day": "sun",
      "time": "22:00"
    }
  ]
}'

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "network": "youtube",
  "timezone": "America/Sao_Paulo",
  "slots": [
    {
      "weekday": 0,
      "day": "sun",
      "time": "22:00",
      "active": true
    },
    {
      "weekday": 1,
      "day": "mon",
      "time": "12:00",
      "active": true
    },
    {
      "weekday": 5,
      "day": "fri",
      "time": "17:30",
      "active": true
    }
  ],
  "rescheduled": []
}

Erros

Status code Quando
400 empty_body O corpo veio vazio.
400 invalid_json O corpo não é um objeto JSON.
413 body_too_large O corpo passa de 1 MB.
422 invalid_field Horário ou dia inválido, mais de 100 horários ou fuso desconhecido.
404 channel_not_found A rede não está conectada.
404 unknown_network Rede desconhecida.

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

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.