Możliwe funkcje:

• zarejestrowanie nowego użytkownika przez partnera
• wysyłanie wiadomości e-mail do nowo zarejestrowanego użytkownika z loginem oraz hasłem do serwisu

Aby prawidłowo wysłać żądanie rejestracji, niezbędne są: nazwa partnera oraz klucz autoryzacji partnera ( symetryczny wygenerowany w serwisie lub asymetryczny wygenerowany samodzielnie przez użytkownika). Klucze generowane i podawane są w panelu administracyjnym użytkownika. Klucz symetryczny jest kluczem publicznym, natomiast klucz asymetryczny wymaga znajomości klucza prywatnego dzięki czemu sposób kodowania jest bezpieczniejszy. Klucz można w razie potrzeby przegenerować.

Przykładowa zawartość żądania (json):

{ "Email": "em@il.pl", "NazwaFirmyPelna": "Firma Jawna", "NazwaFirmySkrocona": "Firma Jawna", "Telefon": "+48 123456789", "Regon": null, "NIP": "111-11-11-111", "Wojewodztwo": null, "Gmina": null, "Powiat": null, "Miejscowosc": "Miejscowosc", "Poczta": "Poczta", "KodPocztowy": "00-000", "Ulica": "Ulica", "NumerDomu": "2", "NumerLokalu": "", "PierwszyMiesiacKsiegowania": 4, "PierwszyRokKsiegowania": 2010, "FormaPrawna": "OF", "RozpVatowiec": true, "RokRozpoczeciaVatowiec": null, "MiesiacRozpoczeciaVatowiec": null, "RokRozpoczeciaDzialalnosci": null, "MiesiacRozpoczeciaDzialalnosci": null, "Wlasciciele": [ { "ImieWlasciciela": "Jan", "NazwiskoWlasciciela": "Kowalski" } ] }

W celu rejestracji należy skonstruować request (POST) w formacie JSON. Request jest zestawem danych rejestracji przedstawionym za pomocą tablicy w formacie danych przedstawionym wyżej. URL ma postać: https://www.ifirma.pl/iapi/abonent/rejestracja

Podawany nagłówek Authentication ma postać:

a) w przypadku klucza symetrycznego:

IAPIS user=nazwaUsera, hmac-sha1=hashWiadomosci hashWiadomosci = hmac(klucz, url + nazwaUsera + nazwaKlucza + requestContent)

HashWiadomosci powinien być zapisany w postaci heksadecymalnej.

b) w przypadku klucza asymetrycznego:

Przykład żądania POST (PHP):

$requestContent = '{"Email":"em@il.pl","NazwaFirmyPelna":"Firma Jawna","NazwaFirmySkrocona":"Firma Jawna","Telefon":"+48 123456789","Regon":null,"NIP":"111-11-11-111","Wojewodztwo":null,"Gmina":null,"Powiat":null,"Miejscowosc":"Miejscowosc","Poczta":"Poczta","KodPocztowy":"00-000","Ulica":"Ulica","NumerDomu":"2","NumerLokalu":"","PierwszyMiesiacKsiegowania":4,"PierwszyRokKsiegowania":2010,"FormaPrawna":"DG","RozpVatowiec":true,"RokRozpoczeciaVatowiec":null,"MiesiacRozpoczeciaVatowiec":null,"RokRozpoczeciaDzialalnosci":null,"MiesiacRozpoczeciaDzialalnosci":null,"Wlasciciele":[{"ImieWlasciciela":"Jan","NazwiskoWlasciciela":"Kowalski"}]}'; $klucz = ""; $url = ""; $nazwaUsera = ""; $nazwaKlucza = "abonent"; $curlHandle = curl_init($url); $hashWiadomosci = hmac($klucz,$url.$nazwaUsera.$nazwaKlucza.$requestContent); $headers=array( 'Accept: application/json', 'Content-type: application/json; charset=UTF-8', 'Authentication: IAPIS user='.$nazwaUsera.', hmac-sha1='.$hashWiadomosci ); curl_setopt($curlHandle, CURLOPT_TIMEOUT, 300); curl_setopt($curlHandle, CURLOPT_CONNECTTIMEOUT,100); curl_setopt($curlHandle, CURLOPT_URL, $url); curl_setopt($curlHandle, CURLOPT_RETURNTRANSFER, true); curl_setopt($curlHandle, CURLOPT_HTTPHEADER, $headers); curl_setopt($curlHandle, CURLOPT_HTTPGET, false); curl_setopt($curlHandle, CURLOPT_POST, true); curl_setopt($curlHandle, CURLOPT_POSTFIELDS, $requestContent); curl_setopt($curlHandle, CURLOPT_SSL_VERIFYHOST,0); curl_setopt($curlHandle, CURLOPT_SSL_VERIFYPEER,0); $rsp = curl_exec($curlHandle);

gdzie:

• klucz - wygenerowany klucz autoryzacji
• url - url pod który wysyłamy requesta
• nazwaUsera - nazwa partnera serwisu ifirma.pl
• nazwaKlucza - identyfiktorKlucza - wartość 'abonent'
• requestContent - zawartość requesta

W rezultacie zarejestrowany użytkownik otrzymuje hasło oraz login do serwisu ifirma.pl na podany w żądaniu adres e-mail.

Nie wiesz jak możesz wykorzystać możliwości, które daje Ci API? Pomożemy Ci! Zapoznaj się z usługami integracji systemów.