04 - Consume API

Introdução

Para acessar a API criada no Django REST framework, siga os passos abaixo. A API está acessível através de rotas prefixadas por api/ conforme configurado no arquivo urls.py. Você pode testar a API usando ferramentas como Postman, Insomnia, ou até mesmo cURL no terminal.

1. URLs Principais da API

Com base na configuração do roteamento, as URLs disponíveis são:

Listar todos os conteúdos: GET /api/contents/
Criar um novo conteúdo: POST /api/contents/
Ver detalhes de um conteúdo específico: GET /api/contents/<id>/
Atualizar um conteúdo: PUT /api/contents/<id>/ (Requer autenticação)
Deletar um conteúdo: DELETE /api/contents/<id>/

2. Acessando via Navegador

Se você estiver rodando o servidor de desenvolvimento do Django localmente, use o comando:

python manage.py runserver

Agora, você pode acessar a API via navegador (ou Postman) em:

Listar — para listar todos os conteúdos.

O Django REST framework oferece uma interface de navegação de API embutida. Se você acessar a API pelo navegador, verá uma interface amigável onde pode visualizar, criar, editar e excluir registros.

3. Exemplos de Requisições

a) GET - Listar todos os conteúdos

Você pode listar todos os conteúdos disponíveis com a seguinte requisição:

Com cURL:

curl -X GET http://127.0.0.1:8000/api/contents/

b) POST - Criar um novo conteúdo

Para criar um novo conteúdo, você precisa estar autenticado e fornecer os dados adequados:

No Postman:

Defina o método como POST.
No campo URL, insira http://127.0.0.1:8000/api/contents/.
Vá até a aba "Body" e selecione raw com o tipo JSON, e insira algo como:

{
    "title": "My Video",
    "description": "A video description",
    "file_url": "http://example.com/video.mp4",
    "thumbnail_url": "http://example.com/thumbnail.jpg",
    "content_type": "video",
    "is_public": true
}

Envie a requisição.

c) PUT - Atualizar um conteúdo

Com cURL:

curl -X PUT http://127.0.0.1:8000/api/contents/<id>/ \
  -H "Content-Type: application/json" \
  -d '{
        "title": "Updated Video Title",
        "description": "Updated description"
      }'

d) DELETE - Remover um conteúdo

Para deletar um conteúdo:

Com cURL:

curl -X DELETE http://127.0.0.1:8000/api/contents/<id>/

Resumo

Acesse a API via http://127.0.0.1:8000/api/contents/.
Use ferramentas como Postman ou cURL para testar os endpoints.
Adicione filtros ou funcionalidades adicionais conforme necessário.

Assim, a API está configurada e pronta para ser consumida por frontends, aplicativos móveis ou outras aplicações REST.