Ó×ÀÑÒÂÓÉÒÅ Â ÎÏÐÎÑÀÕ

Àâòîìàòè÷åñêàÿ XML âûãðóçêà îáúÿâëåíèé

Ïðîôåññèîíàëüíûì ó÷àñòíèêàì ðûíêà êîììåð÷åñêîé íåäâèæèìîñòè Ìîñêâû è âñåõ ðåãèîíîâ Ðîññèè äîñòóïåí áûñòðûé è óäîáíûé ñïîñîá ðàçìåùåíèÿ íà Zdanie.info – îòïðàâêà èíôîðìàöèè îá îáúåêòàõ ÷åðåç XML-âûãðóçêó. Ýòî èçáàâèò Âàñ îò íåîáõîäèìîñòè äîáàâëåíèÿ êàæäîãî îáúÿâëåíèÿ âðó÷íóþ ÷åðåç ôîðìó ðàçìåùåíèÿ îáúåêòîâ è äà¸ò âîçìîæíîñòü åæåäíåâíîãî îáíîâëåíèÿ è ïîäíÿòèÿ âàøèõ îáúÿâëåíèé âûøå â òåìàòè÷åñêîì ðàçäåëå.

XML-âûãðóçêà îñóùåñòâëÿåòñÿ áåñïëàòíî è òîëüêî â ôîðìàòå «Ïðîáíûé» (ïîäðîáíåå î ôîðìàòàõ).
Âû ìîæåòå îòïðàâèòü çàïðîñ íà àäðåñ [email protected], óêàçàâ ñàéò âàøåé êîìïàíèè è ïëàíèðóåìîå êîëè÷åñòâî âûãðóæàåìûõ îáúÿâëåíèé. Âàøà çàÿâêà áóäåò ðàññìîòðåíà è â ñëó÷àå ïîëîæèòåëüíîãî ðåøåíèÿ âàì áóäåò íåîáõîäèìî ïîäãîòîâèòü ôàéë äëÿ âûãðóçêè ñîãëàñíî íèæåïðèâåäåííûì òðåáîâàíèÿì, çàòåì ïðîâåðèòü âàø ôàéë, íàæàâ êíîïêó «Ïðîâåðèòü», è åñëè ôàéë ñîîòâåòñòâóåò òðåáîâàíèÿì, íàæàòü êíîïêó «Äîáàâèòü».  òå÷åíèå ñóòîê âñå îáúåêòû èç âàøåãî ôàéëà áóäóò âûãðóæåíû íà Zdanie.info.

Îáðàòèòå âíèìàíèå: ïðè ïîäãîòîâêå XML-ôàéëà, ïîìèìî íèæåïðèâåä¸ííûõ òåõíè÷åñêèõ òðåáîâàíèé, íåîáõîäèìî ñîáëþäàòü òðåáîâàíèÿ ê îôîðìëåíèþ îáúÿâëåíèé.

URL-àäðåñ XML äîêóìåíòà äîëæåí áûòü ïîñòîÿííûì è äîñòóïíûì ïî ïðîòîêîëó HTTP. Ìàêñèìàëüíîå âðåìÿ óñòàíîâëåíèÿ ñîåäèíåíèÿ è îæèäàíèÿ îòâåòà îò ñåðâåðà, íà êîòîðîì ðàñïîëîæåí XML äîêóìåíò — 30 ñåêóíä.

Ïðîâåðèòü

Òåõíè÷åñêèå òðåáîâàíèÿ

Îáùèå òðåáîâàíèÿ

Ìàêñèìàëüíîå êîëè÷åñòâî îáúåêòîâ â îäíîì äîêóìåíòå — 300 øòóê. Èñïîëüçîâàíèå HTML-òåãîâ â îïèñàíèè îáúåêòîâ çàïðåùåíî. Âñå ÷èñëîâûå çíà÷åíèÿ íå äîëæíû ñîäåðæàòü äåñÿòè÷íûõ çíàêîâ, òî÷åê è çàïÿòûõ, òîëüêî öåëûå ÷èñëà (êðîìå çíà÷åíèé ãåîãðàôè÷åñêèõ êîîðäèíàò îáúåêòà).

Çàãîëîâîê äîêóìåíòà

XML-äîêóìåíò äîëæåí íà÷èíàòüñÿ ñ ïåðâîé ñòðîêè, ñ íóëåâîãî ñèìâîëà è ñîäåðæàòü ñòàíäàðòíûé XML-çàãîëîâîê. Äîïóñêàåòñÿ èñïîëüçîâàíèå òîëüêî êîäèðîâêè UTF-8.

<?xml version="1.0" encoding="utf-8">

Êîðíåâîé ýëåìåíò

Êîðíåâîé ýëåìåíò äîêóìåíòà <commerce> äîëæåí ñîäåðæàòü îáúåêòû âàøåé âûãðóçêè ñãðóïïèðîâàííûå â ýëåìåíòû <offer>.
Ïåðåä ïåðâûì ýëåìåíòîì ñ îïèñàíèåì îáúåêòà çàðåãèñòðèðîâàííûå ïîëüçîâàòåëè ñàéòà ìîãóò óêàçàòü ñâîé ëîãèí (e-mail àäðåñ óêàçàííûé ïðè ðåãèñòðàöèè) â òåãå <login>, àòðèáóò email. Ýòîò e-mail àäðåñ èñïîëüçóåòñÿ äëÿ èäåíòèôèêàöèè âàñ (êàê âëàäåëüöà Ëè÷íîãî êàáèíåòà) ñ îáúåêòàìè âàøåé âûãðóçêè è íå áóäåò ïóáëèêîâàòüñÿ íà ñòðàíèöàõ âûãðóæàåìûõ îáúåêòîâ.

<commerce>
    <login email="[email protected]"/>
    <offer>
        ...
    </offer>
    ...
</commerce>

Îïèñàíèå âûãðóæàåìûõ îáúåêòîâ

Îïèñàíèå êàæäîãî îáúåêòà äîëæíî âõîäèòü â ýëåìåíò <offer>. Æèðíûì âûäåëåíû îáÿçàòåëüíûå ê çàïîëíåíèþ ýëåìåíòû è àòðèáóòû.
Ïåðâûì ýëåìåíòîì îïèñàíèÿ îáúåêòà äîëæåí ñëåäîâàòü ýëåìåíò <id>. Ïîðÿäîê ñëåäîâàíèÿ äðóãèõ ýëåìåíòîâ íå èìååò çíà÷åíèÿ.
Åñëè â îïèñàíèè îáúåêòà õîòÿ áû îäèí èç îáÿçàòåëüíûõ ïàðàìåòðîâ áóäåò îòñóòñòâîâàòü èëè ñîäåðæàòü íåäîïóñòèìîå çíà÷åíèå, òî ýòîò îáúåêò áóäåò ïðîïóùåí.
Îòñóòñòâóþùèå â âûãðóçêå îáúåêòû, êîòîðûå áûëè äîáàâëåíû íà ñàéò èç âàøåãî XML ðàíåå, áóäóò àâòîìàòè÷åñêè óäàëåíû.

Ýëåìåíò Îïèñàíèå
id óíèêàëüíûé äëÿ êàæäîãî îáúÿâëåíèÿ èäåíòèôèêàòîð (÷èñëî, ìîæåò áûòü îäèíàêîâûì äëÿ íåñêîëüêèõ îáúåêòîâ, ïðè óñëîâèè ÷òî îáúåêòû áóäóò îòíîñèòñÿ ê ðàçíîìó òèïó ñäåëêè <contract_type>)
contract_type

Òèï ñäåëêè

Âîçìîæíûå çíà÷åíèÿ: 1 – àðåíäà, 2 – ïðîäàæà
commerce_type

Òèï îáúåêòà

Çíà÷åíèå èç ñïðàâî÷íèêà: òèïû îáúåêòîâ
address

Àäðåñ îáúåêòà

Àòðèáóòû:
admin_area ×èñëîâîé èäåíòèôèêàòîð àäìèíèñòðàòèâíîé îáëàñòè
Çíà÷åíèå èç ñïðàâî÷íèêà: àäìèíèñòðàòèâíûå îáëàñòè
locality Íàçâàíèå íàñåëåííîãî ïóíêòà èëè ãîðîäà (íàçâàíèÿ ãîðîäîâ óêàçûâàþòñÿ áåç ïðèñòàâêè «ãîðîä» èëè «ã.», íàçâàíèÿ íàñåë¸ííûõ ïóíêòîâ óêàçûâàþòñÿ âêëþ÷àÿ ðàéîí è åãî òèï). Ïðèìåð: Ìîñêâà; Äçåðæèíñêèé ðàéîí, ïîñåëîê Ñóçäàëüñêèé.
street Íàçâàíèå óëèöû íàñåëåííîãî ïóíêòà èëè ãîðîäà (âêëþ÷àÿ òèï óëèöû, äîïóñêàþòñÿ ñîêðàùåíèÿ). Ïðèìåð: Îçåðíàÿ àëëåÿ; óë. Ñòðîèòåëåé.
house_str Íîìåð äîìà
lon Ãåîãðàôè÷åñêèå êîîðäèíàòû (äîëãîòà)
lat Ãåîãðàôè÷åñêèå êîîðäèíàòû (øèðîòà)
Ãåîãðàôè÷åñêèå êîîðäèíàòû èñïîëüçóþòñÿ äëÿ îïðåäåëåíèÿ ìåñòîïîëîæåíèÿ îáúåêòà íà êàðòå. Çíà÷åíèÿ êîîðäèíàò äîëæíû ñîäåðæàòü òîëüêî ÷èñëà ñ äðîáíîé ÷àñòüþ, ðàçäåëèòåëü — òî÷êà. Åñëè äîëãîòà è øèðîòà íå óêàçàíû, òî êîîðäèíàòû îáúåêòà áóäóò îïðåäåëåíû àâòîìàòè÷åñêè ïî óêàçàííîìó àäðåñó.
metro

×èñëîâîé èäåíòèôèêàòîð ñòàíöèè ìåòðî (äëÿ Ìîñêâû è Ñàíêò-Ïåòåðáóðãà)

Àòðèáóòû:
id ×èñëîâîé èäåíòèôèêàòîð ñòàíöèè ìåòðî
Çíà÷åíèå èç ñïðàâî÷íèêà: äëÿ Ìîñêâû, äëÿ Ñàíêò-Ïåòåðáóðãà
wtime Ðàññòîÿíèå äî ñòàíöèè ìåòðî â ìèíóòàõ (ïåøêîì)
ttime Ðàññòîÿíèå äî ñòàíöèè ìåòðî â ìèíóòàõ (òðàíñïîðòîì)
Äîïóñêàåòñÿ óêàçûâàòü òîëüêî îäèí èç àòðèáóòîâ wtime è ttime. Åñëè óêàçàíû îáà àòðèáóòà, òî áóäåò ó÷òåíî òîëüêî ðàññòîÿíèå äî ìåòðî ïåøêîì.
price

Öåíà îáúåêòà (÷èñëî). Äëÿ îáúåêòîâ ñ òèïîì Àðåíäà óêàçûâàåòñÿ öåíà àðåíäû êâàäðàòíîãî ìåòðà îáúåêòà â ãîä. Äëÿ îáúåêòîâ ñ òèïîì Ïðîäàæà — öåíà ïðîäàæè âñåãî îáúåêòà.  êà÷åñòâå èñêëþ÷åíèÿ äîïóñêàåòñÿ íå óêàçûâàòü öåíó îáúåêòà (â ñëó÷àå, åñëè öåíà äàííîãî îáúåêòà ÿâëÿåòñÿ êîíôèäåíöèàëüíîé èíôîðìàöèåé).

Àòðèáóòû:
currency

Âàëþòà

Âîçìîæíûå çíà÷åíèÿ: USD, EUR, RUB èëè RUR
square Ïëîùàäü îáúåêòà (÷èñëî) â ì2
description Îïèñàíèå îáúåêòà (ñèìâîëüíûå äàííûå, ìàêñèìàëüíàÿ äëèíà 1000 ñèìâîëîâ). Òåêñò îïèñàíèÿ îáúåêòà íå äîëæåí áûòü íàïèñàí ÇÀÃËÀÂÍÛÌÈ áóêâàìè. Íå äîïóñêàåòñÿ óêàçàíèå êîíòàêòíîé èíôîðìàöèè â îïèñàíèè îáúåêòà. Òåêñò îïèñàíèÿ äîëæåí áûòü ïîìåù¸í âíóòðü êîíñòðóêöèè CDATA. Ïðèìåð:
<![CDATA[
Ïðîäàåòñÿ îòäåëüíî-ñòîÿùåå çäàíèå îôèñíîãî íàçíà÷åíèÿ ïëîùàäüþ 753 êâ.ì,
êëàññ B.
]]>
photo Ñïèñîê URL-àäðåñîâ ñ ôîòîãðàôèÿìè îáúåêòà â ïîðÿäêå èõ îòîáðàæåíèÿ (ïåðâîå ôîòî áóäåò èñïîëüçîâàòüñÿ â ñïèñêå îáúåêòîâ â ñîîòâåòñòâóþùåì ðàçäåëå, âñå ïîñëåäóþùèå — íà ñòðàíèöå îáúåêòà). Âîçìîæíî óêàçàíèå íåñêîëüêèõ òåãîâ (äî 10). URL-àäðåñà ôîòîãðàôèé äîëæíû áûòü äîñòóïíû ïî ïðîòîêîëó HTTP è èìåòü ðàñøèðåíèÿ jpg èëè png. Íà ôîòî íå äîëæíî áûòü êàêèõ-ëèáî ïîñòîðîííèõ èçîáðàæåíèé (âîäÿíûõ çíàêîâ, ëîãîòèïîâ è äð.). Ðåêîìåíäóåìûé ðàçìåð èçîáðàæåíèé — 900x600 px, ìàêñèìàëüíûé — 1200x800 px, ìèíèìàëüíûé — 570x380 px (èçîáðàæåíèÿ ìåíüøå ìàêñèìàëüíîãî èëè áîëüøå ìàêñèìàëüíîãî ðàçìåðà íå áóäóò çàãðóæåíû).  ðàìêàõ îäíîãî îáúÿâëåíèÿ äóáëè èçîáðàæåíèé íå ïðèíèìàþòñÿ. Êàê èñêëþ÷åíèå, äîïóñêàåòñÿ ïóáëèêàöèÿ îáúåêòîâ áåç ôîòî, íî íå áîëåå 10% îò îáùåãî êîëè÷åñòâà.
contacts

Ýëåìåíò-êîíòåéíåð, ñîäåðæàùèé êîíòàêòíûå äàííûå ïî îáúåêòó. Äîïóñêàåòñÿ óêàçûâàòü òîëüêî îäèí íàáîð êîíòàêòîâ äëÿ êàæäîãî îáúåêòà.

Âëîæåííûå ýëåìåíòû:
email E-mail àäðåñ äëÿ îáðàòíîé ñâÿçè
phone Êîíòàêòíûå òåëåôîíû (äîïóñêàåòñÿ óêàçàíèå íåñêîëüêèõ íîìåðîâ ÷åðåç "òî÷êó ñ çàïÿòîé")
name Êîíòàêòíîå ëèöî
company

Íàèìåíîâàíèå êîìïàíèè

Àòðèáóòû:
status

Ñòàòóñ êîìïàíèè

Âîçìîæíûå çíà÷åíèÿ: 0 - Ñîáñòâåííèê, 1 - Óïðàâëÿþùàÿ êîìïàíèÿ, 2 - Ïðåäñòàâèòåëü ñîáñòâåííèêà, 3 - Àãåíòñòâî íåäâèæèìîñòè

Ïðèìåð XML äîêóìåíòà

<?xml version="1.0" encoding="utf-8" ?>
<commerce>
    <login email="[email protected]"/>
    <offer>
        <id>123</id>
        <contract_type>2</contract_type>
        <commerce_type>109</commerce_type>
        <address admin_area="1" locality="Ìîñêâà" street="Âåðõíÿÿ Ïåðâîìàéñêàÿ óë." house_str="7" lon="37.793624" lat="55.799254"/>
        <metro id="108" wtime="10"/>
        <price currency="USD">65000</price>
        <square>155</square>
        <description>
            <![CDATA[ Ïðîäàåòñÿ îòäåëüíî-ñòîÿùåå çäàíèå îôèñíîãî íàçíà÷åíèÿ ïëîùàäüþ 155 êâ.ì, êëàññ B. ]]>
        </description>
        <photo>http://lorempixel.com/output/city-q-c-900-600-1.jpg</photo>
        <photo>http://lorempixel.com/output/city-q-c-900-600-2.jpg</photo>
        <photo>http://lorempixel.com/output/city-q-c-900-600-3.jpg</photo>
        <photo>http://lorempixel.com/output/city-q-c-900-600-4.jpg</photo>
        <contacts>
            <company status="2">Íàèìåíîâàíèå êîìïàíèè</company>
            <name>Âëàäèìèð</name>
            <email>[email protected]</email>
            <phone>+7 (123) 456-78-90; 8 (800) 543-76-98</phone>
        </contacts>
    </offer>
    <offer>
        <id>456</id>
        <contract_type>1</contract_type>
        <commerce_type>157</commerce_type>
        <address admin_area="1" locality="Ìîñêâà" street="Øîññåéíàÿ óë."/>
        <metro id="111" ttime="15"/>
        <price currency="RUB">9500</price>
        <square>370</square>
        <description>
            <![CDATA[ Ñîáñòâåííèê ñäàåò â àðåíäó îòàïëèâàåìûé ñêëàä â 10 ìèíóòàõ îò ìåòðî Ïå÷àòíèêè, Òåêñòèëüùèêè. Ïëîùàäü ñêëàäà 220 êâ.ì, ïëîùàäü îôèñà (øîóðóìà) 150 êâ.ì. ]]>
        </description>
        <photo>http://lorempixel.com/output/city-q-c-900-600-5.jpg</photo>
        <contacts>
            <email>[email protected]</email>
            <phone>+7 (123) 456-78-90</phone>
        </contacts>
    </offer>
</commerce>

https://zdanie.info/sample_export.xml

ïîäîæäèòå ...
HotLog