API Empregos Yoyota

Visão geral

A API é pública e somente leitura para os endpoints abaixo — não é necessária autenticação nem chave de acesso para consultar vagas. Todas as respostas são devolvidas em formato application/json e seguem sempre a mesma estrutura (envelope):

{
  "message": "Operation performed successfully.",
  "data": { ... },
  "license": "This API was developed by Edivaldo Jorge (https://github.com/jorgeedvaldo)"
}

• message — estado da operação.
• data — o conteúdo pedido (objeto paginado na listagem; array no detalhe).
• license — informação de autoria. Agradecemos que mantenha a atribuição ao reutilizar os dados.

URL base: https://empregosyoyota.net/api

1. Listar vagas

GET https://empregosyoyota.net/api/jobs

Devolve as vagas de emprego de Angola, ordenadas da mais recente para a mais antiga, paginadas em 50 por página.

Parâmetros de query

Parâmetro	Tipo	Obrigatório	Descrição
page	inteiro	Não	Número da página a obter. Por omissão é 1. Ex.: ?page=2.

Exemplo de requisição

curl -s "https://empregosyoyota.net/api/jobs?page=1" \
  -H "Accept: application/json"

Exemplo de resposta

{
  "message": "Operation performed successfully.",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 1234,
        "title": "Técnico de Informática",
        "slug": "tecnico-de-informatica",
        "company": "Empresa Exemplo, Lda",
        "province": "Luanda",
        "description": "<p>Descrição completa da vaga...</p>",
        "email_or_link": "rh@empresa.co.ao",
        "photo": "job.jpg",
        "country_id": 1,
        "created_at": "2026-06-20T10:15:00.000000Z",
        "updated_at": "2026-06-20T10:15:00.000000Z",
        "categories": [
          {
            "id": 3,
            "name": "Tecnologia",
            "pivot": { "job_id": 1234, "category_id": 3 }
          }
        ]
      }
    ],
    "first_page_url": "https://empregosyoyota.net/api/jobs?page=1",
    "from": 1,
    "last_page": 12,
    "next_page_url": "https://empregosyoyota.net/api/jobs?page=2",
    "path": "https://empregosyoyota.net/api/jobs",
    "per_page": 50,
    "prev_page_url": null,
    "to": 50,
    "total": 587
  },
  "license": "This API was developed by Edivaldo Jorge (https://github.com/jorgeedvaldo)"
}

Nota: o objeto data é um paginador padrão do Laravel. Use os campos next_page_url, last_page e total para percorrer todas as páginas.

2. Obter uma vaga por ID

GET https://empregosyoyota.net/api/jobs/{id}

Devolve os dados de uma única vaga, incluindo as suas categorias. Substitua {id} pelo identificador numérico da vaga (campo id devolvido na listagem).

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
id	inteiro	Sim	ID da vaga a consultar.

Exemplo de requisição

curl -s "https://empregosyoyota.net/api/jobs/1234" \
  -H "Accept: application/json"

Exemplo de resposta

{
  "message": "Operation performed successfully.",
  "data": [
    {
      "id": 1234,
      "title": "Técnico de Informática",
      "slug": "tecnico-de-informatica",
      "company": "Empresa Exemplo, Lda",
      "province": "Luanda",
      "description": "<p>Descrição completa da vaga...</p>",
      "email_or_link": "rh@empresa.co.ao",
      "photo": "job.jpg",
      "country_id": 1,
      "created_at": "2026-06-20T10:15:00.000000Z",
      "updated_at": "2026-06-20T10:15:00.000000Z",
      "categories": [
        { "id": 3, "name": "Tecnologia" }
      ]
    }
  ],
  "license": "This API was developed by Edivaldo Jorge (https://github.com/jorgeedvaldo)"
}

Se o ID não existir, data será um array vazio [].

Campos de uma vaga

Campo	Tipo	Descrição
id	inteiro	Identificador único da vaga.
title	texto	Título da vaga.
slug	texto	Identificador amigável usado nos links do site.
company	texto	Nome da empresa.
province	texto	Província / localização.
description	HTML	Descrição completa da vaga (pode conter marcação HTML).
email_or_link	texto	E-mail ou link para candidatura.
photo	texto	Nome do ficheiro da imagem. URL completo: https://empregosyoyota.net/storage/<photo>
country_id	inteiro	País da vaga (1 = Angola).
created_at	data ISO 8601	Data de publicação.
updated_at	data ISO 8601	Data da última atualização.
categories	array	Lista de categorias associadas à vaga.

Exemplos de consumo

JavaScript (fetch)

fetch('https://empregosyoyota.net/api/jobs', {
  headers: { 'Accept': 'application/json' }
})
  .then(response => response.json())
  .then(result => {
    const jobs = result.data.data; // array de vagas
    jobs.forEach(job => console.log(job.title, '-', job.company));
  })
  .catch(error => console.error(error));

PHP

<?php
$response = file_get_contents('https://empregosyoyota.net/api/jobs');
$result = json_decode($response, true);

foreach ($result['data']['data'] as $job) {
    echo $job['title'] . ' - ' . $job['company'] . PHP_EOL;
}

Python (requests)

import requests

response = requests.get('https://empregosyoyota.net/api/jobs',
                        headers={'Accept': 'application/json'})
result = response.json()

for job in result['data']['data']:
    print(job['title'], '-', job['company'])

Obter uma vaga específica (cURL)

curl -s "https://empregosyoyota.net/api/jobs/1234" -H "Accept: application/json"

Boas práticas e termos de uso

• Os dados são fornecidos gratuitamente para uso lícito.
• Mantenha a atribuição presente no campo license e, sempre que possível, indique a Empregos Yoyota como fonte.
• Faça uso responsável: evite pedidos excessivos. Recomenda-se aplicar cache do lado do cliente, já que as vagas são atualizadas periodicamente.
• O conteúdo de description pode incluir HTML — sanitize-o antes de o apresentar.