O feed universal fornece dados formatados em XML com possibilidade de escolha de campos, escolha de tags XML, limite de data dos registros por dias ou data específica e limite de registros por requisição.
Identificação
O serviço de feed depende de cadastro prévio para identificação da origem das requisições, bem como tratamento especial de resultados. Para identificação a url deve receber uma variável partner que identifique a parceria.
Por exemplo, ?partner=example
Solicite identificação gratuitamente em dev@microframeworks.com
https://br.empregara.com/api/feed/
A url para consumo deve se parecer com isso:
https://br.empregara.com/api/feed/?partner=example (testar)
Este exemplo possui apenas 12 registros de limite por padrão.
O feed pode ser personalizado. Ele possui os seguintes campos:
Para escolher os campos use a variável fields com os campos desejados separados por traço simples "-".
Exemplo: fields=id-url-title-description-date-local
Este exemplo possui o local, além das obrigatórias que mesmo assim devem ser declaradas ao se optar por personalizar.
As tags que envolvem os dados podems ser personalizadas da mesma forma, mas com a variável tags.
Exemplo: tags=jobid-link-titulo-descricao-data-cidade
Atenção: por padrão os rótulos (tags) são iguais aos campos (fields). Para que você determine eles, devem declarar explicitamente assim como os campos (fields) porque não pode haver discrepância de número entre eles.
Exemplo combinando escolha de campos (fields) e rótulos (tags):
https://br.empregara.com/api/feed/?partner=example&fields=id-url-title-description-date-local&tags=jobid-link-titulo-descricao-data-cidade (testar)
O elemento container é o elemento que "envelopa" cada registro individual. É importante para o controle do feed. Seu rótulo pode ser determinado com a variável chamada item. Basta acrescentar, por exemplo, item=elemento na url de requisição. Por padrão seu valor é "job".
Se o limite de tempo for em dias, basta usar a variável days apontando para o número de dias.
Exemplo: days=5
Caso a abordagem seja com uma data limite, o formato deve ser YYYY-mm-ddYYYY-mm-dd e a variável usada deve ser date_limit.
Exemplo: date_limit=2022-02-27.
Para limite de registros, basta usar a variável jobs_limit com um valor inteiro.
Exemplo: jobs_limit=12