Universal XML Feed Export



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


Url base do feed para:

https://br.empregara.com/api/feed/


Url para consumo (default):

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.


Personalizando resultados

O feed pode ser personalizado. Ele possui os seguintes campos:

[Obrigatórios]
[Opcionais]

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.


Personalizando rótulos (tags)

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)


Personalizando o rótulo do elemento container

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".


Escolhendo limites de tempo

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.


Escolhendo limites de registros

Para limite de registros, basta usar a variável jobs_limit com um valor inteiro.
Exemplo: jobs_limit=12