Documentação API
Se pretende obter autorização de aplicação por favor contacte-nos e indique qual o objectivo da sua aplicação.
O número de business.locations é ilimitado assim como o número de contactos em cada location.
O update pode ser parcial.
Como suporte pode também ser usada a acção Deleted.
Uma API fácil
- A API do motores24h assenta numa simples arquitectura REST
- Não existem campos codificados. Basta que nos forneça os dados tal e qual se escrevem.
- Quer exportar grandes quantidades de anúncios para o motores24h? Faça-o em segundos.
- Tem um site ou aplicação e quer importar os nossos anúncios? Não podia ser mais fácil
- 200 OK
- 400 Bad Request
- 401 Unauthorized
- 403 Forbidden
- 404 Not Found
- 500 Internal Server Error
- 503 Service Unavailable
- O utilizador normalmente registado no motores24h e que pretende aceder à sua conta programaticamente.
- Uma aplicação que pretende fazer a gestão de uma ou mais contas de utilizador ou importar os nossos anúncios.
REST endpoint
https://www.motores24h.pt/api/Requests permitidos
GET, POST, PUT, DELETERespostas possíveis
Autorização
O acesso à API pode ser feito por dois tipos de utilizadores:Para se autorizar junto da API deve ser fornecida a chave de acesso no parâmetro key
www.motores24h.pt/api/user?key=[api key]
Limitações
Cada utilizador está limitado a 1000 requests/min. Para envio imediato de grandes quantidades de dados deve ser usado a acção dumpSandbox
Para testes deve ser usada a sandbox adicionando o parâmetro sandbox a todos os requestswww.motores24h.pt/api/user?sandbox=1&key=[api key]
User
- Este recurso permite criar e editar utilizadores. Não é possível apagar utilizadores via API.
- A criação de utilizadores só é permitida a aplicações.
REST endpoint
https://www.motores24h.pt/api/user/Requests permitidos
GET, POST, PUTAutorização de aplicações
- Ao adicionar um utilizador, uma aplicação fica automaticamente autorizada a manipular os dados do mesmo.
- No caso de o utilizador já existir no motores24h esse utilizador terá de autorizar na sua conta o acesso à aplicação em Aplicações
Pedido de autorização
- Uma aplicação pode requerer autorização de acesso à conta de um utilizador.
- O utilizador pode dar autorização de leitura e/ou escrita ao nível dos anúncios e leitura e/ou escrita aos nível da sua conta pessoal.
- Ao requerer autorização de acesso será enviado um email ao utilizador.
Request
GET www.motores24h.pt/api/user/email/[email]?key=[api key]
Resposta
Se o utilizador existe
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <user id="4e23086e24143a4a012f31000" ></user> </response>
Se o utilizador não existe
<?xml version="1.0" encoding="UTF-8"?> <response code="404"> <error>O utilizador não existe.</error> </response>Para pedir a permissão
Request
GET www.motores24h.pt/api/user/permission/[user id]?key=[api key]
Resposta
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> </response>
GET User
GET www.motores24h.pt/api/user/[user id]?key=[api key]
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <user id="4ee3487744182ff250000003" created="2011-12-10" changed="2011-12-10"> [...] </user> </response>
Exemplo resposta de erro
<?xml version="1.0" encoding="UTF-8"?> <response code="404"> <error>O utilizador não existe.</error> </response>
POST User
Propriedades obrigatórias
- firstname
- lastname
- town
- business.name*
- business.location.email*
- business.location.name*
- business.location.town*
O número de business.locations é ilimitado assim como o número de contactos em cada location.
Request
POST www.motores24h.pt/api/user/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <user> <firstname><![CDATA[António]]></firstname> <lastname><![CDATA[Simões]]></lastname> <email>antonio.simoes@standburnout.pt</email> <cellular>960000000</cellular> <town>Porto</town> <business> <name><![CDATA[Stand Burnout]]></name> <fiscal_id>500332134</fiscal_id> <description><![CDATA[Há vinte anos a servir os nossos clientes.]]></description> <logo><![CDATA[http://www.standburnout.pt/logo.png]]></logo> <sitecolor>red</sitecolor> <!-- valores possíveis "red, green, gray, yellow, blue, orange -->" <locations> <item> <name><![CDATA[Porto]]></name> <town><![CDATA[Porto]]></town> <address><![CDATA[Rua da Boavista 601, 4100-010]]></address> <latitude>41.1564081</latitude> <longitude>-8.6203578</longitude> <url><![CDATA[www.standburnout.pt/porto]]></url> <email> <item>porto@standburnout.pt</item> <item>jp.simoes@standburnout.pt</item> </email> <phone> <item>221234567</item> <item>221234549</item> </phone> <cellular> <item>960000000</item> <item>910000000</item> </cellular> <fax> <item>221234567</item> <item>223459890</item> </fax> </item> <item> <name><![CDATA[Gaia]]></name> <town><![CDATA[Vila Nova de Gaia]]></town> <address><![CDATA[Avenida da República 45]]></address> <latitude>41.1221521</latitude> <longitude>-8.6061564</longitude> <url><![CDATA[www.standburnout.pt/gaia]]></url> <email> <item>gaia@standburnout.pt</item> <item>antonio.simoes@standburnout.pt</item> </email> <phone> <item>223456732</item> <item>227654321</item> </phone> <cellular> <item>923456577</item> </cellular> <fax> <item>223456732</item> </fax> </item> </locations> </business> </user>
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <user id="4ee3457f44182fdb50000003"> <location id="4ee3457f44182fdb50000001"></location> <location id="4ee3457f44182fdb50000002"></location> </user> </response>
Exemplo resposta de erro
<?xml version="1.0" encoding="UTF-8"?> <response code="400"> <user > <error attribute="firstname">Nome é obrigatório.</error> <error attribute="fiscal_id">NIF é é válido.</error> <error attribute="location.0.email.1">Email é obrigatório.</error> <error attribute="location.1.town">Town é obrigatório.</error> </user> </response>
PUT User
- Os updates podem ser parciais.
- Se for enviada uma location sem id é inserida como nova e colocada no fim da lista de locations
- Para reordenar/apagar/adicionar todas as locations devem ser enviadas no payload as locations existentes com as respectivas ids (e eventualmente locations adicionais) na ordem desejada e com o atributo action="reset"
- Para apagar uma location individualmente pode ser usado o recurso DELETE Location
Request
PUT www.motores24h.pt/api/user/[user id]?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <user> <email>antonio.manuel.simoes@standburnout.pt</email> </user>
Payload com reset de locations
<?xml version="1.0" encoding="UTF-8"?> <user> <business> <locations action="reset"> <item id="4f5f146a44182fc231000002"> <name><![CDATA[Porto]]></name> <town><![CDATA[Porto]]></town> <address><![CDATA[Rua da Boavista 601, 4100-010]]></address> <latitude>41.1564081</latitude> <longitude>-8.6203578</longitude> <url><![CDATA[www.standburnout.pt/porto]]></url> <email> <item>porto@standburnout.pt</item> <item>jp.simoes@standburnout.pt</item> </email> <phone> <item>221234567</item> <item>221234549</item> </phone> <cellular> <item>960000000</item> <item>910000000</item> </cellular> <fax> <item>221234567</item> <item>223459890</item> </fax> </item> <item id="4f5f146a44182fc231000003"> <name><![CDATA[Gaia]]></name> <town><![CDATA[Vila Nova de Gaia]]></town> <address><![CDATA[Avenida da República 45]]></address> <latitude>41.1221521</latitude> <longitude>-8.6061564</longitude> <url><![CDATA[www.standburnout.pt/gaia]]></url> <email> <item>gaia@standburnout.pt</item> <item>antonio.simoes@standburnout.pt</item> </email> <phone> <item>223456732</item> <item>227654321</item> </phone> <cellular> <item>923456577</item> </cellular> <fax> <item>223456732</item> </fax> </item> <item> <name><![CDATA[Feira]]></name> <town><![CDATA[Santa Maria da Feira]]></town> <address><![CDATA[Avenida da República 45]]></address> <latitude>41.1221521</latitude> <longitude>-8.6061564</longitude> <url><![CDATA[www.standburnout.pt/gaia]]></url> <email> <item>feira@standburnout.pt</item> <item>antonio.simoes@standburnout.pt</item> </email> <phone> <item>223456732</item> <item>227654321</item> </phone> <cellular> <item>923456577</item> </cellular> <fax> <item>223456732</item> </fax> </item> </locations> </business> </user>
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <user id="4ee3457f44182fdb50000003"></user> </response>
Location
REST endpoint
https://www.motores24h.pt/api/location/Requests permitidos
DELETEDELETE Location
São devolvidos na resposta os ads cuja location foi apagada. A estes ads é atribuída a location principal (primeira) do user.Request
DELETE www.motores24h.pt/api/location/[location id]?key=[api key]
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <location id="4ee3457f44182fdb50000003"> <ad id="42e3456f44182fdb50000005"></ad> <ad id="42e3456f44182fdb50000006"></ad> </location> </response>
Exemplo resposta de erro
<?xml version="1.0" encoding="UTF-8"?> <response code="404"> <error>A localização não existe.</error> </response>
Ad
Descrição
Recurso comum que engloba todos os tipos de anúncios.Ad type
- auto - automóveis ligeiros de passageiros
- autovan - automóveis comerciais ligeiros
- autotruck - automóveis comerciais pesados
- autohome - autocaravanas
- autoclassic automóveis clássicos
- moto - motos
- motoclassic - motos clássicas
- boat - barcos
- part - peças e acessórios
Unidades
- volume - centímetro cúbico
- potência - cv e hp (adboat)
- comprimento - mm e km (mileage)
- massa - kg
- moeda - euro
REST endpoint
https://www.motores24h.pt/api/ad[type]/Requests permitidos
GET, POST, PUT, DELETEGET Ad
É obrigatório usar o endpoint correspondente ao type de anúncio que pretende visualizar.GET www.motores24h.pt/api/ad[ad type]/[ad id]?key=[api key]
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <user id="4ee3487744182ff250000003" created="2011-12-10" changed="2011-12-10"> [...] </user> </response>
Exemplo resposta de erro
<?xml version="1.0" encoding="UTF-8"?> <response code="404"> <error>O anúncio não existe.</error> </response>
POST Ad
Se não especifica o type no endpoint terá de o indicar no payload de cada ad.Request
POST www.motores24h.pt/api/ad/[ad type]?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad> [...] </ad>
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <ad id="4ee3457f44182fdb50000003"></ad> </response>
Exemplo resposta de erro
<?xml version="1.0" encoding="UTF-8"?> <response code="400"> <ad> <error attribute="model">Modelo é obrigatório</error> </ad> </response>
PUT Ad
Se não especifica o type no endpoint terá de o indicar no payload de cada ad.O update pode ser parcial.
Request
PUT www.motores24h.pt/api/ad[ad type]/[ad id]?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad> <price>10000</price> </ad>
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <ad id="4ee3457f44182fdb50000003"></ad> </response>
DELETE Ad
É obrigatório usar o endpoint correspondente ao type de anúncio que pretende apagar.Request
DELETE www.motores24h.pt/api/ad[ad type]/[ad id]?key=[api key]
Resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> </response>
POST Ad.Dump
- Para de forma simples e rápida alterar todos os anúncios.
- Num dump todos os anúncios que estão presentes no payload são inseridos/actualizados e todos os anúncios que não estejam presentes em relação ao último update são apagados.
- Todos os anúncios devem ter um attributo ref (o id interno do parceiro) de forma a reconhecermos o anúncio e para facilitar o output de erros.
- Anúncios a actualizar devem obrigatoriamente indicar o seu id caso contrário serão inseridos como novos anúncios.
POST www.motores24h.pt/api/ad[type]/dump?key=[api key]ou
POST www.motores24h.pt/api/ad/dump?key=[api key]em que o type é indicado como attributo no xml de cada anúncio.
<?xml version="1.0" encoding="UTF-8"?> <ads> <ad ref="12345" type="auto" user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> [...] </ad> </ads>Se o atributo location for omitido é assumida a location primária do user.
Payload
<?xml version="1.0" encoding="UTF-8"?> <ads> <!-- Novo anúncio especificando uma location --> <ad ref="12345" user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> [...] </ad> <!-- Update de anúncio --> <ad ref="32454" id="4ee3ba0444182f0051000047" user="4d5964aa73143a2720040000"> [...] </ad> <!-- Novo anúncio sem especificar location --> <ad ref="24324" user="4d5964aa73143a2720040000"> [...] </ad> </ads>
Exemplo resposta de sucesso
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <ad ref="12345" id="4ee3ba0444182f0051000047"></ad> <ad ref="32454" id="4ee3ba0444182f0051000048"></ad> <ad ref="24324" id="4ee3ba0444182f0051000049"></ad> </response>
Exemplo resposta de erro
<?xml version="1.0" encoding="UTF-8"?> <response code="400"> <ad ref="12345"> <error attribute="model">Modelo é obrigatório.</error> </ad> <ad ref="32454" id="4ee3ba0444182f0051000048"></ad> <ad ref="24324" id="4ee3ba0444182f0051000049"></ad> </reponse>
GET Ad.Dump
No âmbito do nosso serviço Multisite vários sites parceiros importam anúncios do motores24h.pt para incluir nas suas listagens.GET www.motores24h.pt/api/ad[type]/dump?key=[api key]
Parâmetros.
Podem ser usados vários parâmetros que facilitam a importação.- type=[auto,moto,...] - Limita o/os tipos de anúncios a listar. Só com o endpoint www.motores24h.pt/api/ad
- limit=[integer] - Limita a list ao número de anúncios indicado
- offset=[integer] - Inicia a lista no offset indicado
- since=[unix timestamp] - Lista anúncios adicionados/alterados desde a data indicada
- mode=incremental - Só lista anúncios ainda não importados.
Como suporte pode também ser usada a acção Deleted.
Exemplo resposta
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <ads> <ad type="auto" id="4ee4cdb873143a3b7d450000" created="11/12/2011" changed="11/12/2011"> <url><![CDATA[https://www.motores24h.pt/audi-a4-1.9-tdi-m6-sport-carro-4ee4cdb873143a3b7d450000/]]></url> <title><![CDATA[AUDI A4 1.9 TDi M6 Sport]]></title> <obs><![CDATA[Impecável]]></obs> <price>11900</price> <price_info> <item><![CDATA[Preço negociável]]></item> <item><![CDATA[Aceita troca]]></item> </price_info> <make><![CDATA[AUDI]]></make> <model><![CDATA[A4 Diesel]]></model> <version><![CDATA[A4 1.9 TDi M6 Sport]]></version> <color><![CDATA[Preto]]></color> <year>2001</year> <month>10</month> <fuel><![CDATA[Diesel]]></fuel> <body_type><![CDATA[]]></body_type> <doors>4</doors> <seats>5</seats> <mileage>210000</mileage> <gearbox><![CDATA[Manual]]></gearbox> <engine_size>1896</engine_size> <owners>2</owners> <power>130</power> <warranty><![CDATA[12 Meses]]></warranty> <equipment> <item><![CDATA[AUX IN]]></item> <item><![CDATA[Airbag]]></item> <item><![CDATA[Alarme]]></item> <item><![CDATA[Ar Condicionado]]></item> <item><![CDATA[Caixa de CDs]]></item> <item><![CDATA[Controlo de tracção]]></item> <item><![CDATA[Cruise Control]]></item> <item><![CDATA[ESP]]></item> <item><![CDATA[Faróis de nevoeiro]]></item> </equipment> <files> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee4cd5273143ae04b830000/9d86c006.jpg]]></item> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee4cd5c73143a7f60590000/ecdf6dd9.jpg]]></item> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee4cd6373143ae04b930000/3bfa0582.jpg]]></item> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee4cd6c73143a0641840000/368b3112.jpg]]></item> <item type="video"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee4cd7873143a922a180300/82bef706.jpg]]></item> </files> <user id="4e231d4773143a7301ed0555" type="business"> <name><![CDATA[JOCAR]]></name> <email><![CDATA[4e231d4773143a7301ed0555@motores24h.pt]]></email> <phone><![CDATA[220000000]]></phone> <cellular><![CDATA[910000000]]></cellular> </user> <town><![CDATA[Vila Nova de Poiares]]></town> </ad> [...] </ads> </response>
GET Ad.Deleted
Como suporte ao GET Ad.Dump pode ser usada esta acção que devolve os anúncios apagados com um limite temporal de até 1 mês.GET www.motores24h.pt/api/ad[type]/deleted?key=[api key]
Parâmetros.
- type=[auto,moto,...] - Limita o/os tipos de anúncios a listar. Só com o endpoint www.motores24h.pt/api/ad
- since=[unix timestamp] - Lista anúncios apagados desde a data indicada
Exemplo resposta
<?xml version="1.0" encoding="UTF-8"?> <response code="200"> <ads> <ad id="4ee3d67973143a3550b60000"/> <ad id="4ee3d67973143a3550b80000"/> <ad id="4ee3d67973143a3550ba0000"/> </ads> </response>
Adauto
Descrição
Automóveis ligeiros de passageiros (type=auto).REST endpoint
https://www.motores24h.pt/api/adauto/POST Adauto
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- owners
- body_type
- gearbox
Request
POST www.motores24h.pt/api/adauto/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[BMW]]></make> <model><![CDATA[Z4]]></model> <version><![CDATA[35is]]></version> <month>2</month> <year>2009</year> <owners>1</owners> <mileage>11000</mileage> <price>45000</price> <price_info> <item>Preço negociável</item> <item>Preço sem ISV</item> </price_info> <power>306</power> <engine_size>2996</engine_size> <body_type><![CDATA[Roadster]]></body_type> <fuel><![CDATA[Gasolina]]></fuel> <color><![CDATA[Azul]]></color> <gearbox><![CDATA[Manual]]></gearbox> <drive_wheels>2</drive_wheels> <doors>2</doors> <seats>2</seats> <equipment> <item><![CDATA[ABS]]></item> <item><![CDATA[Xénon]]></item> <item><![CDATA[GPS]]></item> </equipment> <warranty><![CDATA[12 meses]]></warranty> <obs><![CDATA[Simplesmente Impecável]]></obs> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Adautovan
Descrição
Automóveis comerciais ligeiros (type=autovan).REST endpoint
https://www.motores24h.pt/api/adautovan/POST Adautovan
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- owners
- body_type
- gearbox
Request
POST www.motores24h.pt/api/adautovan/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[Opel]]></make> <model><![CDATA[Corsa Van]]></model> <version><![CDATA[1.3CDTI]]></version> <obs><![CDATA[Fecho centralizado c/ comando; Espelhos retrovisores eléctricos; Airbag condutor; Leitor de cd’s c/ comandos no volante; Vidro dianteiros eléctricos que fecham c/ comando; ABS; Direcção assistida; Próxima revisão aos 80.000km's. Pneus novos. IVA dedutível!]]></obs> <price>7500</price> <price_info> <item><![CDATA[Aceita trocas]]></item> <item><![CDATA[IVA dedutível]]></item> </price_info> <color><![CDATA[Branco]]></color> <year>2009</year> <month>3</month> <fuel><![CDATA[Diesel]]></fuel> <body_type><![CDATA[Van]]></body_type> <doors>2</doors> <seats>2</seats> <mileage>58000</mileage> <gearbox><![CDATA[Manual]]></gearbox> <engine_size>1300</engine_size> <drive_wheels>2</drive_wheels> <owners>1</owners> <power>75</power> <warranty><![CDATA[12 meses]]></warranty> <equipment> <item><![CDATA[ABS]]></item> <item><![CDATA[Xénon]]></item> <item><![CDATA[GPS]]></item> </equipment> <files> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee27fa373143a895a880000/f62783d7.jpg]]></item> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee27fa173143a3b51ee0000/79bacea8.jpg]]></item> <item type="image"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee27f7773143a3a5e700000/1b7ef17b.jpg]]></item> <item type="video"><![CDATA[https://www.motores24h.pt/file/image/preset/gallery/4ee27f7673143ab85a850000/d90639d5.wmv]]></item> </item> </files> </ad>
Adautotruck
Descrição
Automóveis comerciais ligeiros (type=autotruck).REST endpoint
https://www.motores24h.pt/api/adautotruck/POST Adautotruck
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- owners
- gearbox
Request
POST www.motores24h.pt/api/adautotruck/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[Volvo]]></make> <model><![CDATA[FL6 14]]></model> <obs><![CDATA[muito estimado tem plataforma e compressor revisão feita]]></obs> <price>5500</price> <price_info> <item><![CDATA[Aceita troca]]></item> </price_info> <color><![CDATA[Branco]]></color> <year>1990</year> <month>5</month> <fuel><![CDATA[Diesel]]></fuel> <cabin_type><![CDATA[Longa]]></cabin_type> <gross_weight>12000</gross_weight> <mileage>505000</mileage> <gearbox><![CDATA[Manual]]></gearbox> <engine_size>6900</engine_size> <owners>1</owners> <power>200</power> <warranty><![CDATA[12 Meses]]></warranty> <equipment> <item><![CDATA[ABS]]></item> <item><![CDATA[Xénon]]></item> <item><![CDATA[GPS]]></item> </equipment> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Adautohome
Descrição
Autocaravanas (type=autohome).REST endpoint
https://www.motores24h.pt/api/adautovan/POST Adautohome
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- owners
- body_type
- gearbox
Request
POST www.motores24h.pt/api/adautohome/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[Fiat]]></make> <model><![CDATA[Ducato MacLouis 6 Lugares]]></model> <obs><![CDATA[GARANTIA INTERNACIONAL 2 ANOS]]></obs> <price>38000</price> <price_info> <item><![CDATA[Aceita troca]]></item> </price_info> <color><![CDATA[Branco]]></color> <year>2007</year> <month>9</month> <fuel><![CDATA[Diesel]]></fuel> <body_type><![CDATA[Integral]]></body_type> <seats>6</seats> <beds>6</beds> <mileage>7122</mileage> <gearbox><![CDATA[Manual]]></gearbox> <engine_size>2298</engine_size> <owners>1</owners> <power>96</power> <warranty><![CDATA[24 Meses]]></warranty> <equipment> <item><![CDATA[ABS]]></item> <item><![CDATA[Xénon]]></item> <item><![CDATA[GPS]]></item> </equipment> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Adautoclassic
Descrição
Automóveis clássicos (type=autoclassic).REST endpoint
https://www.motores24h.pt/api/adautoclassic/POST Adautoclassic
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- body_type
- gearbox
Request
POST www.motores24h.pt/api/adautoclassic/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[Volkswagen]]></make> <model><![CDATA[CAROCHA 1300 L]]></model> <obs><![CDATA[Bom estado]></obs> <price>5000</price> <price_info> <item><![CDATA[Aceita troca]]></item> </price_info> <color><![CDATA[Vermelho]]></color> <year>1970</year> <month>2</month> <fuel><![CDATA[Gasolina]]></fuel> <body_type><![CDATA[Coupé]]></body_type> <doors>2</doors> <seats>5</seats> <mileage>57000</mileage> <gearbox>Manual</gearbox> <engine_size>1295</engine_size> <power>65</power> <warranty>12 meses</warranty> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Admoto
Descrição
Motos (type=moto).REST endpoint
https://www.motores24h.pt/api/admoto/POST Admoto
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- moto_type
- owners
Request
POST www.motores24h.pt/api/admoto/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[HONDA]]></make> <model><![CDATA[CBF 250]]></model> <price>2000</price> <color><![CDATA[Preto]]></color> <year>2009</year> <month>3</month> <fuel><![CDATA[Gasolina]]></fuel> <moto_type><![CDATA[Naked]]></moto_type> <mileage>3000</mileage> <engine_size><![CDATA[250]]></engine_size> <owners>1</owners> <power>40</power> <equipment> <item><![CDATA[ABS]]></item> <item><![CDATA[Xénon]]></item> <item><![CDATA[GPS]]></item> </equipment> <warranty><![CDATA[12 meses]]></warranty> <obs><![CDATA[Simplesmente Impecável]]></obs> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Admotoclassic
Descrição
Motos clássicas (type=motoclassic).REST endpoint
https://www.motores24h.pt/api/admotoclassic/POST Admotoclassic
Propriedades obrigatórias
- price
- make
- model
- fuel
- color
- month
- year
- mileage
- moto_type
- owners
Request
POST www.motores24h.pt/api/admotoclassic/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[Vespa]]></make> <model><![CDATA[150 VBB2T de 1964]]></model> <price>2000</price> <color><![CDATA[Preto]]></color> <year>1983</year> <month>3</month> <fuel><![CDATA[Gasolina]]></fuel> <moto_type><![CDATA[Scooter]]></moto_type> <mileage>3000</mileage> <engine_size>250</engine_size> <owners>1</owners> <power>20</power> <warranty><![CDATA[12 meses]]></warranty> <obs><![CDATA[Simplesmente Impecável]]></obs> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Adboat
Descrição
Barcos (type=boat).REST endpoint
https://www.motores24h.pt/api/adboat/POST Adboat
Propriedades obrigatórias
- price
- make
- model
- fuel
- month
- year
- hours
- owners
- power
- boat_type
Request
POST www.motores24h.pt/api/adboat/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <make><![CDATA[Cranchi]]></make> <model><![CDATA[ATLANTIQUE]]></model> <obs><![CDATA[Impecável]]></obs> <price>250000</price> <price_info> <item><![CDATA[Preço negociável]]></item> </price_info> <year>2005</year> <month>5</month> <fuel><![CDATA[Diesel]]></fuel> <boat_type><![CDATA[Barco a motor]]></boat_type> <hull_type><![CDATA[Fibra de Vidro]]></hull_type> <length>1184</length> <beam>383</beam> <draft>300</draft> <seats>3</seats> <hours>400</hours> <owners>3</owners> <power>544</power> <warranty><![CDATA[12 meses]]></warranty> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>
Adpart
Descrição
Peças e acessórios (type=part).REST endpoint
https://www.motores24h.pt/api/adpart/POST Adpart
Propriedades obrigatórias
- title
- price
- obs
- vehicle_type
- condition
Request
POST www.motores24h.pt/api/adpart/?key=[api key]
Payload
<?xml version="1.0" encoding="UTF-8"?> <ad user="4d5964aa73143a2720040000" location="4d59683f73143a921404000"> <title><![CDATA[JANTES AUDI A 4 15" ORIGINAIS]]></title> <condition><![CDATA[Usado]]></condition> <vehicle_type><![CDATA[Usado]]></vehicle_type> <obs><![CDATA[EXCELENTE ESTADO]]></obs> <price>150</price> <price_info> <item><![CDATA[Preço negociável]]></item> </price_info> <warranty><![CDATA[12 meses]]></warranty> <files> <item type="video">http://www.standburnout.pt/12339.wmv</item> <item type="image">http://www.standburnout.pt/12339.jpg</item> <item type="image">http://www.standburnout.pt/34566.jpg</item> <item type="image">http://www.standburnout.pt/32432.jpg</item> <item type="image">http://www.standburnout.pt/31232.jpg</item> </files> </ad>