Eksport Ofert do serwisu ogłoszeniowego ogloszenia.infoludek.pl

Podobne dokumenty
Dokumentacja techniczna SMS MO

Dokumentacja Techniczna SMS MO

PAŁACE I PARKI WebAPI

Dokumentacja techniczna SMS MO

Specyfikacja wysyłek marketingowych v1.10

Specyfikacja instalacji usługi SMS Premium w Przelewy24.pl

,Aplikacja Okazje SMS

SYSTEM ZARZĄDZANIA DANYMI OSOBOWYMI - INSTRUKCJA UŻYTKOWNIKA

DOKUMENTACJA TECHNICZNA KurJerzyAPI wersja 1.0

Serwis jest dostępny w internecie pod adresem Rysunek 1: Strona startowa solidnego serwisu

Sms. v Strona 1 z 17. FUTURE-SOFT SP. Z O.O. ul. Gosławicka2/ , Opole tel sales@future-soft.pl NIP:

Certyfikat kwalifikowany

Dokumentacja smsapi wersja 1.4

INSTRUKCJA OBSŁUGI PANELU ADMINISTRACYJNEGO MÓJ DOTPAY v0.1

SMS Kod Automatyczny

Specyfikacja HTTP API. Wersja 1.6

Dokumentacja API BizIn

Integracja sklepu internetowego z serwisem aukcyjnym Swistak.pl

INSTRUKCJA Panel administracyjny

DOKUMENTACJA TECHNICZNA SMS API MT

Profil pracy wariant konfiguracji programu obejmujący m.in język, walutę, konto allegro, szablon aukcji, zdefiniowane koszty wysyłki itp.

Spis treści. Strona: 1/26

Przewodnik użytkownika (instrukcja) AutoMagicTest

Przelewy24 Wirtualny Koszyk

Elektroniczna Skrzynka Podawcza

Podręcznik Użytkownika ING BankOnLine z funkcjonalnością Modułu Użytkowników

JPK w programie Ewa - fakturowanie i magazyn

Kurs walut. Specyfikacja projektu. Marek Zając

1. Składanie wniosku rejestracyjnego - rejestracja konta użytkownika/firmy

INSTRUKCJA. zakładania konta w Społeczności CEO oraz rejestrowania się do programu lub na szkolenie/cykl szkoleniowy KROK 1

E-administracja. Korzystanie z Elektronicznej Platformy Usług Administracji Publicznej

Instalacja rozwiązania Uruchomienie rozwiązania w systemie Sage Konfiguracja dodatku Ustawienia dodatkowe rozwiązania...

Specyfikacja techniczna. mprofi Interfejs API

Profil pracy wariant konfiguracji programu obejmujący m.in język, walutę, konto allegro, szablon aukcji, zdefiniowane koszty wysyłki itp.

Baza numerów Wersja 1.1

INSTRUKCJA UŻYTKOWNIKA

Centrum Informatyki "ZETO" S.A. w Białymstoku. Wysyłanie danych o licencjach i zezwoleniach do CEIDG w systemie ProcEnt Licencje

Dokumentacja techniczna API systemu SimPay.pl

1. Proszę wejść na stronę: poczta.home.pl i zalogować się do nowej skrzynki za pomocą otrzymanych danych.

Mediatel 4B Sp. z o.o., ul. Bitwy Warszawskiej 1920 r. 7A, Warszawa,

Getin Noble Bank SA wersja 1.0 Infolinia

Instrukcja Użytkownika Portalu Ogłoszeń ARiMR

API transakcyjne BitMarket.pl

Dokumentacja Użytkownika Systemu

INTEGRACJA z OLX. Aplikacja Shoper - Dokumentacja. Lęborska 8/10/ Warszawa.

elektroniczna Platforma Usług Administracji Publicznej

Dokumentacja interfejsu HTTPD. Platforma BSMS.PL Instrukcja podłączenia po przez http

Dokumentacja API BizIn

Wdrożenie modułu płatności eservice. dla systemu Zen Cart

1.2 Prawa dostępu - Role

Dokumentacja Użytkownika Systemu. Integracja z Okazje.info, Skąpiec, Sklepy24

Użytkownik organizacji, która posiada kod ZUP ma dwie możliwości składania nominacji/renominacji dobowych:

INSTRUKCJA EDYCJI PROFILU OSOBOWEGO W SERWISIE

Dokumentacja techniczna - PBL

Poradnik zetula.pl. Jak założyć konto na zetula.pl. i zabezpieczyć dane na swoim komputerze?

Archiwum Prac Dyplomowych

Dokumentacja SMS przez FTP

elektroniczna Platforma Usług Administracji Publicznej

Spis treści 1. Założenia ogólne 2. Wymagania 3. Typy SMSów 4. Statusy SMSów 5. Wysyłanie SMSów - Web API 6. Wysyłanie SMSów - 7.

INSTRUKCJA. rejestrowania się na szkolenie/cykl szkoleniowy oraz uzupełniania niezbędnej unijnej dokumentacji uczestnictwa w projekcie (PEFS)

Praca w programie dodawanie pisma.

Podręcznik użytkownika

Kurier DPD dla Subiekt GT

Instrukcja portalu TuTej24.pl

Instrukcja dla użytkowników serwisu internetowego

Dokumentacja Użytkownika Systemu

INSTRUKCJA ZAMAWIANIA KART ŚKUP Z WYKORZYSTANIEM TOKENU DLA UCZNIÓW POSIADAJACYCH MIEJSCE ZAMIESZKANIA NA TERENIE GZM

wfirma (Moduł Magento) v Strona 1 z 12

JPK VAT wysyłka za pośrednictwem profilu zaufanego z systemu epuap

Instrukcja. importu dokumentów. z programu Fakt do programu Płatnik. oraz. przesyłania danych do ZUS. przy pomocy programu Płatnik


SMS Kod Automatyczny

Krok 1. - utworzenie własnego konta w serwisie.

Pierwsze kroki Statusy transakcji Zwrot płatności przelewem lub kartą Odbiór wpłat Czas realizacji płatności...

Instrukcja do programu DoGLS 1.0

Przewodnik po konfiguracji Comarch ERP e-sklep z wszystko.pl

Zmiana sposobu logowania do systemu Bazy Wiedzy PW edycja danych

INSTRUKCJA AKTYWACJI I OBSŁUGI BRAMKI SMS DLA FIRM. (Bramka SMS dla małych Firm, Bramka SMS Pro)

Przelewy24 Wirtualny Koszyk

Viatoll Calc v1.3. Viatoll Calc. Instrukcja użytkownika. Strona 1

Usługa Moje faktury w ING BankOnLine

INSTRUKCJA UŻYTKOWNIKA SYSTEMU WEB SIBIG 2.0 MIGRACJA DANYCH Z PC DŁUŻNIK

Automater.pl zdalne tworzenie i zarządzanie transakcjami dokumentacja API wersja 0.1

Instrukcja dostępu do usługi Google Scholar

Instrukcja użytkownika Porównywarki cen Liquid

Bramka płatnicza. Dokumentacja techniczna. wersja 1.0

Instrukcja pobrania i instalacji. certyfikatu niekwalifikowanego na komputerze lub karcie kryptograficznej. wersja 1.4 UNIZETO TECHNOLOGIES SA

Dokumentacja użytkownika systemu

Instrukcja obsługi Modułu Payu dla Moodle 2.x

Instrukcja dla użytkownika korzystającego z Usługi Moje faktury

Aby skorzystać z wyżej wymienionych funkcji zaloguj się na swoje konto w e-dok zgodnie z opisanymi poniżej 7 krokami:

Instrukcja korzystania z usługi 2SMS. Wersja 2.0 [12 stycznia 2014] bramka@gsmservice.pl

Składanie wniosku w Pekao24 krok po kroku

Przewodnik dla użytkownika. Instrukcja korzystania z aplikacji mobilnej mtoken Asseco MAA

Przewodnik dla studentów i absolwentów.

INSTRUKCJA OBSŁUGI APLIKACJI WEBFAX DLA UŻYTKOWNIKA

REFERAT O PRACY DYPLOMOWEJ

Spis treści. Rejestracja/logowanie. Zmiana numeru konta klienta. Tworzenie nowej przesyłki. Zamawianie kuriera

Instrukcja obsługi certyfikatów w programie pocztowym MS Outlook Express 5.x/6.x

Transkrypt:

Eksport Ofert do serwisu ogłoszeniowego ogloszenia.infoludek.pl Wrzesień 2014

Spis treści: Wprowadzenie... 3 Struktura danych do eksportu... 4 Eksport ofert w trybie testowym... 5 Sekcja 'klient'... 5 Sekcja 'oferty'... 6 Parametry sekcji 'oferty'... 7 Sekcja 'kategoria'... 8 Parametry sekcji 'kategoria -> kategoria extra'... 9 Sekcja 'lokalizacja'... 10 Sekcja 'kontakt'... 11 Parametry 'cena', 'waluta' i 'zdjecia'... 12 'DODATEK' - Struktura potwierdzenia eksportu... 13 'DODATEK' - PHP, funkcja realizująca eksport (PHP, curl(... 15 'DODATEK' - Wykaz kategorii... 16

Wprowadzenie. Dokument jest instrukcją, opisującą sposób przygotowania zestawu danych i wykonania ich eksportu do naszego serwisu ogłoszeniowego. Opisaną w dokumencie funkcjonalność adresujemy do użytkowników (firm, którzy chcieliby zamieszczać większe ilości swoich ofert w naszym serwisie ogłoszeniowym (np. agencje: nieruchomości i pośrednictwa pracy, komisy samochodowe, itd..., bez potrzeby ich "ręcznego" przepisywania - wysyłając wprost z własnego systemu. Możliwość eksportu swoich ofert może mieć każdy, kto: posiada założone i aktywne konto użytkownika (jako firma w naszym serwisie, posiada środki ('ludki' - waluta wirtualna wystarczające do zamieszczenia eksportowanych ofert, zaimplementuje opisaną w tym dokumencie funkcjonalność w swoim systemie. Jak działa eksport?.. 1. Użytkownik we własnym systemie wybiera oferty i uruchamia polecenie ich eksportu do naszego serwisu ogłoszeniowego *, 2. z wybranych powyżej ofert serwis użytkownika tworzy tablicę danych o wymaganej strukturze (będacej tematem niniejszego opracowania, 3. gotowy zestaw danych wysyłany * jest za pomocą metody POST pod adres http://ogloszenia.infoludek.pl/api/eksport/start/klucz,a7cc4u6ttr5wsdcgfbgbgrr26lkykrr4fwref, 4. po odebraniu danych i poprawnej autoryzacji klienta - system ogłoszeniowy wykonuje operacje zamieszczenia lub usunięcia kolejnych ofert, 5. w odpowiedzi odsyłana jest tablica (array(, zawierająca m.in. status wykonania eksportu, wynik wykonania operacji dla każdej z zamieszczonych, usuniętych lub odrzuconych ofert oraz podsumowanie salda (liczby 'ludków' na koncie użytkownika, 6. oprócz odpowidzi "technicznej" - serwis ogłoszeniowy wysyła również raport wykonania eksportu na adres e-mail klienta. * - sposób, w jaki użytkownik będzie wykonywał te czynności w swoim systemie określą programiści, wdrażający opisaną funkcjonalność. Przykłady zamieszczone w niniejszej instrukcji oparte są na języku PHP. Strona 3 / 17

Tablica (array( STRUKTURA DANYCH DO EKSPORTU (Array(. Zestaw (tablica danych, który zostanie wyeksportowany do naszego serwisu składa się z trzech głownych parametrów: 1. test (integer, 2. klient (array(, 3. oferty (array(. poszczególnych parametrów i przykłady ich zastosowania zostaną omówione w kolejnych punktach. Przykładowy zestaw danych do eksportu: array => array ( test => 1, klient => array ( email => biuro@moja.firma.xyz, id => 372852, hash => b6f9fcde954d48a515e9985cb1746c4a, oferty => array ( 0 => array ( nr_oferty => FTS/422-02/2014, akcja => add_one, tytul => Piękny dom w Kołobrzegu - sprzedam., tresc => Sprzedam duży, piękny dom w Kołobrzegu itd..., kategoria => nieruchomosci_sprzedam_domy, kategoria_extra => array ( nieruchomosci => array ( powierzchnia => 87.5, pjed => m2, pietro => 7, ile_pokoi => 3, lokalizacja => array ( kraj => Polska, wojewodztwo => zachodniopomorskie, miasto => Kołobrzeg, kontakt => array ( wlacz_nadawca => 1, wlacz_adres => 0, wlacz_telefon => 1, wlacz_email => 1, nadawca => Jerzy Kowalski, telefon => 914...562, email => inne.biuro@firmaxy.yzx, www => moja.stronawww.xyz, cena => 287500.5, waluta => PLN, zdjecia => array ( 0 => http://moja_firma.xyz/images/img23022.jpg, 1 => http://moja_firma.xyz/images/img12003.jpg, 2 => http://moja_firma.xyz/images/img00333.jpg, 1 => array ( nr_oferty => Nr kolejnej oferty..., akcja => delete, tytul => Volvo S80 sprzedam lub zamienię., tresc => Volvo S80, pełna opcja, stan idealny sprzedam lub..., kategoria => auto_moto, itd...itp.. =>... Strona 4 / 17

Parametr test PARAMETR "test" (integer test => 1 Akceptowane wartości: 1 lub 0 (zero. Ustawienie parametru test => 1 umożliwia wykonanie próbnego eksportu ofert do naszego serwisu ogłoszeniowego. W tym trybie NIE jest wykonywany "fizyczny" zapis ofert i NIE są pobierane żadne opłaty z konta klienta ("ludki" - waluta wirtualna. Przeprowadzana jest natomiast symulacja wszystkich operacji np. identyfikacja klienta, kontrola poprawności danych w ofertach, liczbę 'ludków' na koncie klienta, itp... W odpowiedzi serwis ogłoszeniowy zwraca tablicę (zobacz w sekcji 'DODATEK' - "Potwierdzenie eksportu", zawierającą m.in: Status wykonania (kod błędu, Listy ofert dodanych, odrzuconych i wyłączonych (oferty odrzucone posiadają krótkie uzasadnienie powodu ich pominięcia, Symulację salda (liczby 'ludków' na koncie użytkownika ((w oparciu o realny stan konta i rezultat eksportu. Niezależnie od wybranego trybu - po każdym wykonaniu eksportu klient otrzyma wysłany drogą mailową raport, zawierający statusy eksportu poszczególnych ofert i saldo konta. klient PARAMETR "klient" (array( Wartością parametru klient jest tablica, zawierająca informacje niezbędne do identyfikacji użytkownika w serwisie ogłoszeniowym. Parametr email (string Adres e-mail, na który zostanie wysłany raport o stanie eksportu. Jeżeli ten parametr będzie pominięty - użyty zostanie e-mail z konta klienta w serwisie ogłoszeniowym. id (integer ID Klienta w serwisie ogłoszeniowym. hash (string Identyfikator (hash UWAGA: Aby pobrać ID Klienta i Identyfikator (hash klient musi posiadać aktywne konto (jako firma w serwisie ogloszenia.infoludek.pl. Sposób pobrania ID Klienta i Identyfikatora (hash: zalogować się na swoje konto w serwisie http://ogloszenia.infoludek.pl, kliknąć przycisk "Mój profil" (pasek klienta, w środkowej części strony, pod wyszukiwarką, zaznaczyć i skopiować obie wymagane wartości parametrów: 'ID' i 'hash' (są widoczne w połowie wysokości formularza. klient => array ( email => biuro@moja.firma.xyz, id => 372852, hash => b6f9fcde954d48a515e9985cb1746c4a Strona 5 / 17

oferty PARAMETR "oferty" (array( Parametr "oferty" jest tablicą wielowymiarową, zawierającą kolejno indeksowane oferty do eksportu. oferty => array ( 0 => array ( nr_oferty => FTS/422-02/2014, akcja => add_one, tytul => Piękny dom w Kołobrzegu - sprzedam., tresc => Sprzedam duży, piękny dom w Kołobrzegu itd..., kategoria => nieruchomosci_sprzedam_domy, kategoria_extra => array ( nieruchomosci => array ( powierzchnia => 87.5, pjed => m2, pietro => 7, ile_pokoi => 3, auto_moto => array ( rodzaj => osobowe, marka => Peugeot, rocznik => 1997, lokalizacja => array ( kraj => Polska, wojewodztwo => zachodniopomorskie, miasto => Kołobrzeg, kontakt => array ( wlacz_nadawca => 1, wlacz_adres => 0, wlacz_telefon => 1, wlacz_email => 1, nadawca => Jerzy Kowalski, telefon => 914...562, email => inne.biuro@firmaxy.yzx, www => moja.stronawww.xyz, cena => 287500.5, waluta => PLN, zdjecia => array ( 0 => http://moja_firma.xyz/images/img23022.jpg, 1 => http://moja_firma.xyz/images/img12003.jpg, 2 => http://moja_firma.xyz/images/img00333.jpg, 1 => array ( nr_oferty => Nr kolejnej oferty..., akcja => delete, tytul => Volvo S80 sprzedam lub zamienię., tresc => Volvo S80, pełna opcja, stan idealny sprzedam lub..., kategoria => auto_moto, itd...itp.. =>... Strona 6 / 17

Parametr nr_oferty ( wymagane! PARAMETR "nr_oferty" (string "Nr oferty" musi zawierać unikatowy identyfikator oferty, nadany w systemie klienta (np.id oferty w bazie danych lub nr ref.. nr_oferty => FTS/422-02/2014 akcja ( wymagane! PARAMETR "akcja" (string Akcja - określa sposób zachowania się naszego serwisu w przypadku konfliktu "nr oferty" z już istniejącym ogłoszeniem, pozwala także usunąć (wyłączyć nieaktualne ogłoszenia. Dopuszczalne wartości: add_one, add_next, delete Wartość add_one add_next delete Ogłoszenie z takim "nr_oferty" będzie zamieszczone tylko raz. Ponowna próba eksportu tej oferty zostanie odrzucona. Pozwala ponownie zamieścić ogłoszenie z takim samym "nr_oferty" (lecz nie tego samego dnia. Polecenie usunięcia (wyłączenia wszystkich aktywnych ogłoszeń klienta z takim "nr_oferty". Użycie wartości 'delete' wymaga podania jedynie parametru 'nr_oferty', pozostałe parametry oferty można pozostawić niewypełnione, a na koncie użytkownika może być zerowe saldo ludków. akcja => add_one tytul ( wymagane! PARAMETR "tytul" (string Tytuł zamieszczonej oferty musi zawierać 'czysty tekst'. Całkowita długość tekstu nie może przekroczyć 50 znaków. Ewentualne tagi html i znaki specjalne zostaną usunięte. Jeżeli tytuł nadal nie będzie spełniał powyższych warunków - oferta zostanie odrzucona. Powiadomienie o przyczynie odrzucenia będzie zamieszczone w e-mailu, zawierającym raport wykonania eksportu. tytul => Piękny dom w Kołobrzegu - sprzedam. tresc ( wymagane! PARAMETR "tresc" (string Treść zamieszczonej oferty musi zawierać 'czysty tekst'. Całkowita długość tekstu nie może przekroczyć 1800 znaków. Ewentualne tagi html i znaki specjalne zostaną usunięte. Jeżeli treść nadal nie będzie spełniała powyższych warunków - oferta zostanie odrzucona. Powiadomienie o przyczynie odrzucenia będzie zamieszczone w e-mailu, zawierającym raport wykonania eksportu. tresc => Sprzedam duży, piękny dom w Kołobrzegu itd... Strona 7 / 17

Parametr kategoria ( wymagane! PARAMETR "kategoria" (string Kategoria musi zawierać jeden ze zdefiniowanych ciągów tekstowych, znajdujących się sekcji "DODATEK - Wykaz kategorii". Błędna wartość parametru kategoria spowoduje odrzucenie oferty! kategoria => nieruchomosci_sprzedam_domy kategoria_extra PARAMETR "kategoria_extra" (array( W przypadku, gdy wartość w kluczu "kategoria" (kategoria główna rozpoczyna się jednym z poniższych ciągów tekstowych: nieruchomosci_ auto_moto_ można dodać dodatkowe parametry, chociaż wypełnienie ich nie jest wymagane. Objaśnienia tablic, paramtrów i ich dopuszczalnych wartości znajdują się w kolejnych punktach. Przykład 1: Jeżeli kategoria => nieruchomosci_sprzedam_domy można dodać dodatkowe parametry: kategoria_extra => array ( nieruchomosci => array ( powierzchnia => 87.5, pjed => m2, pietro => 7, ile_pokoi => 3 ; Przykład 2: Jeżeli kategoria => auto_moto można dodać dodatkowe parametry: kategoria_extra => array ( auto_moto => array ( rodzaj => osobowe, marka => Peugeot, rocznik => 1997 ; Strona 8 / 17

Parametr nieruchomosci PARAMETR "kategoria_extra => nieruchomosci" ( array Tablica dodatkowych parametrów dla kategorii głownej "nieruchomosci" (niewymagane: powierzchnia (float Podać powierzchnię nieruchomości lub pozostawić niewypełnione. pjed (string pietro (integer Jednostka, w której podano powierzchnię nieruchomości. Pozostawić niewypełnione lub użyć jednej z poniższych opcji: 'm2', 'ha', 'km2', 'ar'. Podać numer piętra lub pozostawić niewypełnione. ile_pokoi (integer Podać liczbę pokoi lub pozostawić niewypełnione. kategoria_extra => array ( nieruchomosci => array ( powierzchnia => 87.5, pjed => m2, pietro => 7, ile_pokoi => 3 ; auto_moto PARAMETR "kategoria_extra => auto_moto" (array( Tablica dodatkowych parametrów dla kategorii głownej "auto_moto" (niewymagane: rodzaj (string marka (string rocznik (integer Pozostawić niewypełnione lub użyć jednej z poniższych opcji: 'osobowe', 'busy / ciężarowe', 'motocykle', 'części'. Pozostawić niewypełnione lub podać markę pojazdu np: 'Audi', 'Seat', 'Fiat'... Podać rocznik lub pozostawić niewypełnione. kategoria_extra => array ( auto_moto => array ( rodzaj => osobowe, marka => Peugeot, rocznik => 1997 ; Strona 9 / 17

Parametr lokalizacja ( wymagane! PARAMETR "lokalizacja" (array( Wartością parametru jest tablica, zawierającą dane o lokalizacji (miasto, województwo, kraj przedmiotu oferty. Gdy przedmiot oferty dotyczy całego kraju lub całego województwa - można wypełnić tylko jeden z tych parametrów. Jeżeli jednak oferta dotyczy konkretnej miejscowości - oprócz parametru 'miasto' należy również podać przynajmniej 'wojewodztwo'. Przed zamieszczeniem oferty nasz serwis sprawdza prawidłowość (istnienie podanej lokalizacji a powyższy wymóg umożliwia jednoznaczne jej określenie. Często się zdarza, że w kilku województwach można znaleźć miejscowość o tej samej nazwie. kraj (string Podać nazwę kraju lub pozostawić niewypełnione. wojewodztwo (string Podać nazwę województwa (regionu, lub pozostawić niewypełnione. miasto (string Jeżeli podano 'miasto' - parametr 'wojewodztwo' (i/lub kraj musi być wypełnione. lokalizacja => array ( kraj => Polska, wojewodztwo => zachodniopomorskie, miasto => Kołobrzeg Strona 10 / 17

Parametr kontakt PARAMETR "kontakt" (array( Parametr jest tablicą, zawierającą dane kontaktowe ogłoszeniodawcy. Serwis ogłoszeniowy wymaga, aby podany został przynajmniej jeden z parametrów: 'telefon' lub 'email'. W przypadku braku obu tych parametrów serwis ogłoszeniowy automatycznie włączy i uzupełni parametr 'telefon', pobierając go z danych zawartych w profilu użytkownika. wlacz_nadawca 1 (pokaż lub 0 (ukryj wlacz_adres 1 (pokaż lub 0 (ukryj Jeżeli parametr=1, tekst zawarty w parametrze nadawca będzie pokazany w ogłoszeniu. Jeżeli włączony lecz nie podano nadawcy, serwis ogłoszeniowy uzupełni ten parametr danymi z profilu użytkownika. Jeżeli parametr=1 serwis ogłoszeniowy pobierze dane adresowe z profilu użytkownika. wlacz_telefon 1 (pokaż lub 0 (ukryj wlacz_email 1 (pokaż lub 0 (ukryj nadawca (string telefon (string email (string www (string Jeżeli parametr=1, tekst zawarty w parametrze telefon będzie pokazany w ogłoszeniu. Jeżeli włączony lecz nie podano telefonu, serwis ogłoszeniowy pobierze telefon z profilu użytkownika. Jeżeli parametr=1, tekst zawarty w parametrze email będzie pokazany w ogłoszeniu. Jeżeli włączony lecz nie podano adresu email lub adres będzie zawierał błędy, serwis ogłoszeniowy uzupełni email, pobierając go z profilu użytkownika. Parametr włącza/wyłącza również adres www. Nazwa firmy lub Imię i nazwisko. Jeżeli podano - zostaną użyte zamiast danych z profilu użytkownika. Numer telefonu. Jeżeli podano - zostanie użyty zamiast nr telefonu z profilu użytkownika. Adres email. Jeżeli podano - zostanie użyty zamiast adresu email z profilu użytkownika. Adres WWW. Jeżeli podano - zostanie użyty zamiast adresu www z profilu użytkownika kontakt => array ( wlacz_nadawca => 1, wlacz_adres => 0, wlacz_telefon => 1, wlacz_email => 1, nadawca => Jerzy Kowalski, telefon => 914...562, email => inne.biuro@firmaxy.yzx, www => moja.stronawww.xyz Strona 11 / 17

Parametr cena PARAMETR "cena" (float Podać cenę oferty ( parametr niewymagany. cena => 287500.5 waluta PARAMETR "waluta" (string Jeżeli podano cenę, należy również podać kod waluty ( parametr niewymagany. Jeżeli podano cenę lecz nie wypełniono parametru waluta - użyta zostanie wartość 'PLN'. Dopuszczalne wartości to: 'PLN', 'EUR', 'USD'. waluta => PLN zdjecia PARAMETR "zdjecia" (array( Parametr zdjecia jest tablicą, w której należy umieścić linki do dołączanych zdjęć. Każda z ofert można zawierać maks. 6 zdjęć. Wysłanie większej liczby linków nie spowoduje błędu, a nadmiarowe pozycje zostaną po prostu pominięte. zdjecia => array ( 0 => http://moja_firma.xyz/images/img23022.jpg, 1 => http://moja_firma.xyz/images/img12003.jpg, 2 => http://moja_firma.xyz/images/img00333.jpg Uwaga: Każda z ofert można zawierać maks. 6 zdjęć, Wartość musi być pełnym adresem URL do zdjęcia (z 'http://' włącznie, Akceptowane formaty plików to: 'jpg', 'png' i 'gif', Zdjęcia, w których długość dłuższego boku jest większa niż 800px będą skalowane (zachowując proporcje do tego rozmiaru. Strona 12 / 17

DODATEK. STRUKTURA POTWIERDZENIA EKSPORTU (array( Tablica (odpowiedź zwracana do systemu użytkownika po wykonaniu eksportu. Użytkownik otrzyma również raport o stanie wykonania eksportu na adres podany w parametrze 'klient=>email'. status => OK_BUT_NO_PREPAID, test => 1, raport => array (,, dodane => array (, 0 => array ( nr_oferty => KST/001-02-0914, id_ogloszenia => 707497 1 => array ( nr_oferty => 123-456-CSS/2014, id_ogloszenia => 707498 wylaczone => array ( 0 => array ( nr_oferty => TTH/003/01/2014, id_ogloszenia => 705352 odrzucone => array ( 0 => array ( nr_oferty => FTS/422/02/2014, powod => Jedna lub więcej ofert z tym samym "Nr Oferty" były już wcześniej dodane: ID Ogłoszenia:707550, : 2014-09-03 12:54:34, ważne do 2014-12-03 11:54:34, 1 => array ( nr_oferty => CWWF/333/04/2014, powod => Oferta była zaznaczona "Do Usunięcia". Niestety, nie znaleziono żadnych aktywnych ogłoszeń z podanym "Nr Oferty"., 2 => array ( nr_oferty => BBA/333/02-2014, powod => Oferta nie została dodana z powodu braku środków (ludków na Państwa koncie. Prosimy uzupełnić stan konta i ponownie wykonać eksport, prepaid_start_saldo => 14, prepaid_paid => 3, prepaid_end_saldo => 11 Strona 13 / 17

Lista wartości parametru "status" i ich znaczenie: FAIL_URL_HASH Błąd zgodności hash-a w adresie URL, FAIL_JSON_DECODE FAIL_USER_IDENTITY FAIL_RECORDS FAIL OK_BUT_NO_PREPAID OK_BUT_NO_PARTIAL_PREPAID OK Błąd przetwarzania / dekodowania odebranego zestawu danych. UWAGA: Dane do wysyłki muszą być zakodowane w formacie "JSON". Błąd autoryzacji klienta. Jeżeli klient zmodyfikuje swoje dane w serwisie ogłoszeniowym - należy ponownie pobrać i zaktualizować parametr klient => hash. Błąd - zestaw danych nie zawiera żadnych ofert. Prawdopodobnie parametr 'oferty' nie zawiera żadnych danych. Błąd - inny, nieznany błąd. W takim przypadku prosimy o kontakt, w celu wspólnego ustalenia przyczyny błędu. OK, ale przed rozpoczęciem eksportu stwierdzono brak środków ('ludków' na koncie użytkownika. Wszystkie oferty, które miały być zamieszczone w serwisie ogłoszeniowym zostały pominięte. Brak środków na koncie nie blokuje natomiast możliwości usuwania (wyłączania ogłoszeń. OK, ale podczas trwania eksportu na koncie użytkownika zabrakło środków ('ludków'. Część z ofert przeznaczonych do zamieszczenia została pominięta. Brak środków na koncie nie blokuje natomiast możliwości usuwania (wyłączania ogłoszeń. OK - eksport zakończony pełnym powodzeniem. Lista pozostałych parametrów potwierdzenia i ich znaczenie: test raport=>dodane raport=>wylaczone raport=>odrzucone raport=>prepaid_start_saldo raport=>prepaid_paid raport=>prepaid_end_saldo jeżeli = 1 - eksport został wykonany w Trybie Testowym, tablica ofert pomyślnie zamieszczonych w serwisie ogłoszeniowym, tablica ofert z ustawionym parametrem akcja='delete', które zostały pomyślnie wyłączone (usunięte, tablica ofert odrzuconych, wraz z podaniem powodu ich odrzucenia, liczba 'ludków' na koncie użytkownika przed wykonaniem eksportu, liczba 'ludków' pobranych za zamieszczenie wyeksportowanych ofert, liczba 'ludków' pozostałych na koncie. Strona 14 / 17

DODATEK. FUNKCJA REALIZUJĄCA EKSPORT DANYCH (PHP, curl( Poniżej zamieszczamy gotową funkcję, wysłającą utworzony zestaw ofert metodą POST. Jako parametr funkcji ( $data należy przekazać tablicę z zestawem ofert. Odpowiedź z serwisu ogłoszeniowego będzie dostępna w zmiennej $result. Kod funkcji (PHP : function send_by_curl($data { /* adres url do wysyłki... */ $target_url = "http://ogloszenia.infoludek.pl/api/eksport /start/klucz,a7cc4u6ttr5wsdcgfbgbgrr26lkykrr4fwref"; /* ustawienie parametrów curl i wysłanie pod adres $target_url... */ $ch = curl_init(; curl_setopt($ch, CURLOPT_URL, trim($target_url; curl_setopt($ch, CURLOPT_HEADER, 0; curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt($ch, CURLOPT_POST, true; curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 0; curl_setopt($ch, CURLOPT_TIMEOUT, 180; curl_setopt($ch, CURLOPT_POSTFIELDS, array("json"=>json_encode($data; $output = curl_exec($ch; $curl_info = curl_getinfo($ch; curl_close($ch; /* Potwierdzenie Eksportu - odpowiedź z serwisu ogloszeniowego (array(... */ $result = json_decode($output, TRUE; /* odkomentuj, aby testowo wyświetlić rezultat połączenia curl_exec(... */ //echo "<pre>"; //print_r( $curl_info ; //echo "</pre>"; } /* odkomentuj, aby testowo wyświetlić Potwierdzenie Eksportu... */ echo "<pre>"; print_r( $result ; echo "</pre>"; Strona 15 / 17

DODATEK. WYKAZ KATEGORII Parametr kategoria powinien zawierać ciąg tekstowy (tekst w kolorze odpowiadający żądanej Kategorii. Błędna wartość parametru kategoria spowoduje odrzucenie oferty! Jeżeli oferta ma trafić do kategorii Praca -> Szukam pracownika -> Handel i usługi, parametr kategoria musi zawierać odpowiadający jej ciąg tekstowy: praca_szukam_pracownika_handel_i_uslugi. Praca = praca Szukam pracownika = praca_szukam_pracownika Za granicą = praca_szukam_pracownika_za_granica Sektor IT = praca_szukam_pracownika_sektor_it Handel i usługi = praca_szukam_pracownika_handel_i_uslugi Biuro = praca_szukam_pracownika_biuro Hotele - gastronomia = praca_szukam_pracownika_hotele gastronomia Budownictwo = praca_szukam_pracownika_budownictwo Opieka i au-pair = praca_szukam_pracownika_opieka_i_aupair Medycyna = praca_szukam_pracownika_medycyna Edukacja = praca_szukam_pracownika_edukacja Transport - Spedycja = praca_szukam_pracownika_transport spedycja Call Center = praca_szukam_pracownika_call_center Czasowa/Sezonowa = praca_szukam_pracownika_czasowasezonowa staże/ praktyki = praca_szukam_pracownika_staze_praktyki Inne = praca_szukam_pracownika_inne Szukam pracy = praca_szukam_pracy Za granicą = praca_szukam_pracy_za_granica Sektor IT = praca_szukam_pracy_sektor_it Handel i usługi = praca_szukam_pracy_handel_i_uslugi Biuro = praca_szukam_pracy_biuro Hotele - gastronomia = praca_szukam_pracy_hotele gastronomia Budownictwo = praca_szukam_pracy_budownictwo Opieka i au_pair = praca_szukam_pracy_opieka_i_au_pair Medycyna = praca_szukam_pracy_medycyna Edukacja = praca_szukam_pracy_edukacja Transport - Spedycja = praca_szukam_pracy_transport spedycja Call Center = praca_szukam_pracy_call_center Czasowa/Sezonowa = praca_szukam_pracy_czasowasezonowa staże/ praktyki = praca_szukam_pracy_staze_praktyki Inne = praca_szukam_pracy_inne Dowolna = praca_szukam_pracy_dowolna Zlecę pracę firmie = praca_zlece_prace_firmie Nieruchomości = nieruchomosci Sprzedam = nieruchomosci_sprzedam Mieszkania = nieruchomosci_sprzedam_mieszkania Domy = nieruchomosci_sprzedam_domy Lokale użytkowe/biura = nieruchomosci_sprzedam_lokale_uzytkowebiura Działki = nieruchomosci_sprzedam_dzialki Inne = nieruchomosci_sprzedam_inne Kupię = nieruchomosci_kupie Domy = nieruchomosci_kupie_domy Mieszkania = nieruchomosci_kupie_mieszkania Lokale użytkowe/biura = nieruchomosci_kupie_lokale_uzytkowebiura Działki = nieruchomosci_kupie_dzialki Inne = nieruchomosci_kupie_inne Wynajmę = nieruchomosci_wynajme Domy = nieruchomosci_wynajme_domy Mieszkania = nieruchomosci_wynajme_mieszkania Strona 16 / 17

Lokale użytkowe/biura = nieruchomosci_wynajme_lokale_uzytkowebiura Działki = nieruchomosci_wynajme_dzialki Inne = nieruchomosci_wynajme_inne Zamienię = nieruchomosci_zamienie Domy = nieruchomosci_zamienie_domy Mieszkania = nieruchomosci_zamienie_mieszkania Lokale użytkowe/biura = nieruchomosci_zamienie_lokale_uzytkowebiura Działki = nieruchomosci_zamienie_dzialki Inne = nieruchomosci_zamienie_inne Stancje = nieruchomosci_stancje Szukam = nieruchomosci_stancje_szukam Oferuję = nieruchomosci_stancje_oferuje Strona 17 / 17