Wymagania do Web-Interfejsu korporatywnej witryny dla automatycznego zamieszczenia ofert z systemu E-Staff

Interfejs strony musi podtrzymywać trzy obowiązkowe metody (Dodaj, Zmień i Usuń ofertę).

URL, na którym wywołuje się każda metoda wyznacza się autorami strony i później wskazuje się w ustawieniach E-Staff w trakcie integracji. Protokół dla każdej metody jednoznacznie wyznacza się tę specyfikacją.

Dodawanie/zmiana oferty

Dodawanie i zmiana oferty odbywa się przez protokół HTTP z pomocą standardowego POST-pytania (application/x-www-form-urlencoded). System używa następne pola (obowiązkowe pola odznaczone gwiazdką):

id – kod oferty (tylko dla zmiany) (*)

code – kod oferty wewnątrz E-Staff (*)

name - nazwa oferty(*)

profession_id – kod fachu według rubrykatora strony (*)

city – nazwa miasta (miejscowości)

min_salary – minimalny poziom pensji (USD) (*)

max_salary – maksymalny poziom pensji (USD)

comment – opis oferty (*)

contacts_fullname – osoba kontaktowa

contacts_phone – telefon kontaktowy

contacts_email - email kontaktowy

Jako odpowiedź strona musi zwrócić XML z następną strukturą:

<?xml version="1.0" encoding="iso-8859-2"?>

<result>     

<err>0</err>     

<err_desc></err_desc>      

<id>123456</id>

</result>

gdzie, err – kod błędu (0 – wykonanie z powodzeniem), err_desc – opis błędu, id – kod oferty, przyswojony stroną (wiersz).

Zalecano żeby przez ID zamieszczonej oferty jednoznacznie wyznaczał się URL z którego była by dostępna zamieszczona oferta.

Usuwanie oferty

Dodawanie i zmiana oferty odbywa się przez protokół HTTP z pomocą standardowego POST-pytania (application/x-www-form-urlencoded). System używa następne pola (obowiązkowe pola odznaczone gwiazdką):

id - id oferty (*)

Jako odpowiedź strona musi zwrócić XML z następną strukturą:

<?xml version="1.0" encoding="iso-8859-2"?>

<result>     

<err>0</err>     

<err_desc></err_desc>

</result>

gdzie, err – kod błędu (0 – wykonanie z powodzeniem), err_desc – opis błędu