GotLink API
Zgodnie z prośbą naszych użytkowników, postanowiliśmy udostępnić im API, dzięki któremu będą mogli kontrolować swoje konto
bez konieczności logowania się w naszym serwisie.
Spis treści
Pola "username" oraz "password" to odpowiednio nazwa użytkownika oraz hasło w serwisie GotLink.pl.
Pole "action" określa rodzaj wykonywanej akcji (np. pobieranie danych » "get").
Pole "type" określa rodzaj danych o jakie odpytujemy (np. linki » "links").
Uwaga! Jeśli nie chcesz przesyłać hasła w postaci jawnej, udostępniliśmy możliwość przesyłania samego wyniku funkcji skrótu na haśle, tzn. md5(hasło). Wartość tą należy ustawić w polu "md5pass" i usunąć pole "password".
Przykładowy kod z wykorzystaniem CURLa
Na dzień dzisiejszy możliwe są 2 rodzaje:
- JSON
- Zserializowana tablica
Za wybór sposobu kodowania odpowiada pole "result" w wysyłanym zapytaniu. Możliwe wartości to: "json", "serialize".
Przykład przetworzenia odpowiedzi do tablicy asocjacyjnej w PHP
Sprawdzenie błędów oraz wyświetlenie odpowiedzi
Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Pobranie listy linków z grupy 22 posortowanych wg ilości punktów malejąco
W odpowiedzi otrzymujemy listę rekordów. Każdy rekord zawiera następujące pola:
- "id" - identyfikator linku
- "group_id" - identyfikator grupy
- "add_date" - data dodania linku w formacie UNIX_TIMESTAMP
- "url" - adres URL
- "anchor" - anchor linku
- "title" - title linku
- "text_before" - tekst przed
- "text_after" - tekst po
- "points" - liczba punktów przydzielona na link
- "position" - aktualna pozycja w wyszukiwarce (wartość 0 oznacza brak danych, wartość 127 oznacza pozycję poza pierwszą 100)
- "multilink" - określa czy to jest link czy mutlilink (0 => link, 1 => multilink)
- "lcount" - całkowita liczba pobrań danego linku
Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Pobranie listy grup posortowanych wg id rosnąco
W odpowiedzi otrzymujemy listę rekordów. Każdy rekord zawiera następujące pola:
- "id" - identyfikator grupy
- "name" - nazwa grupy
- "points" - liczba punktów przydzielonych na grupę
Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Pobranie listy stron posortowanych wg ilości zaindeksowanych stron malejąco, pobieramy tylko id strony, wartość zaindeksowanych podstron oraz jej adres url, dodatkowo wybieramy tylko 5 stron z drugiej podstrony wyników.
W odpowiedzi otrzymujemy listę rekordów. Każdy rekord zawiera następujące pola:
- "id" - identyfikator strony
- "site_url" - adres URL strony
- "pagerank" - pagerank
- "time_added" - data dodania
- "site" - wartość SITE
- "type" - typ strony (strony zwykłe bądź erotyka)
- "category" - numer kategorii (w przypadku strony zwykłych)
- "points" - liczba punktów za domenę
- "points_ip" - liczba punktów za unikalne IP domeny
- "points_main" - bonus za domenę główną
- "points_age" - bonus za staż domeny
- "show_links" - liczba wyświetlanych linków na domenie
- "show_texts" - pokazywanie tekstu przed/po (1 => tak, 0 => nie)
- "activated" - czy strona aktywna (0 => nieaktywna, 1 => aktywna, 2 => zbanowana)
- "outgoing" - ilość linków wychodzących z domeny (0 oznacza brak danych, 255 oznacza ponad 250 linków wychodzących)
- "backlink" - wartość Backlink
- "time_update" - ostatnia aktualizacja
Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Pobranie listy przelewów posortowanych wg daty zakończenia rosnąco
W odpowiedzi otrzymujemy dwie tablice ("in" oraz "out"), które zawierają listy przelewów odpowiednio przychodzących oraz wychodzących. Każdy rekord na liście zawiera następujące pola:
- "id" - identyfikator przelewu
- "title" - nazwa przelewu
- "points" - liczba przelanych punktów
- "send_date" - data wykonania przelewu w formacie UNIX_TIMESTAMP
- "cancel_date" - data zakończenia przelewu w formacie UNIX_TIMESTAMP (0 => przelew bezterminowy)
- "nick" - nazwa odbiorcy/nadawcy
Pobranie informacji o koncie
W odpowiedzi otrzymujemy rekord zawierący następujące pola:
- "user_nick" - nazwa użytkownika
- "user_mail" - adres email
- "register_date" - data rejestracji w formacie UNIX_TIMESTAMP
- "points_domains" - liczba punktów za dodane domeny
- "points_partners" - liczba punktów z partnerów
- "points_transfers" - liczba punktów z przelewów (wartość ujemna oznacza, że mamy przelewy wychodzące)
- "points_ip" - liczba punktów za uniklane IP domeny
- "points_age" - liczba punktów za staż domen
- "points_main" - liczba punktów za domeny główne
- "points_autolinker" - punkty pobrane za autolinkowanie
- "points_sum" - suma punktów
- "points_used" - punkty użyte na linki
- "points_left" - wolne punkty na koncie
Lista parametrów przy dodawaniu linków:
Dodanie nowego linku, którego 50% linków będzie pogrubionych oraz będzie sprawdzana pozycja w wyszukiwarce, priorytet: 7, kategoria: Inne, numer grupy: 69
W przypadku sukcesu, w odpowiedzi dostajemy ID dodanego linku.
Lista parametrów przy dodawaniu grupy:
Przykład utworzenia nowej grupy i ustawienia dla niej 10.000 punktów
W przypadku sukcesu, w odpowiedzi dostajemy ID utworzonej właśnie grupy.
Lista parametrów przy dodawaniu multilinków:
Dodanie nowego multilinku z trzeba różnymi anchorami, który będzie pogrubiony, priorytet: 7, kategoria: Inne, numer grupy: 69, zmieniany najpierw będzie anchor co minimum 25 pobrań
W przypadku sukcesu, w odpowiedzi dostajemy ID dodanego linku.
Lista parametrów przy tworzeniu nowego przelewu:
Przykład przelania użytkownikowi "Zbyszek" 50.000 punktów, z ustawieniem końca transferu na 1 styczeń 2013 roku
W przypadku sukcesu, w odpowiedzi dostajemy ID utworzonego transferu.
Dodatkowo parametr "id" określa ID linku, który chcemy usunąć. Możemy usunąć więcej niż jeden link jednym zapytaniem, aby tego dokonać należy poszczególne ID linków oddzielić przecinkiem np. "54,58,89". W jednym zapytaniu można usunąć maksymalnie 50 linków.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Dodatkowo parametr "id" określa ID grupy, którą chcemy usunąć.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Dodatkowo parametr "id" określa ID przelewu, który chcemy anulować
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Dodatkowo parametr "id" określa ID grupy, którą chcemy modyfikować. Parametr "points" określa nową ilość punktów przypisanych do grupy.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Parametr "id" określa ID linku, który chcemy zmodyfikować.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Lista parametrów:
Przykład zmiany priorytetu linku ID 12345 na 7 oraz pogrubienia na 65%
Dodatkowo parametr "id" określa ID linku, który chcemy przenieść, a parametr "group" określa ID grupy do której przeniesiony zostanie link.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Spis treści
- 1. Wprowadzenie
- 2. Zwracane wartości
- 3. Obsługa błędów
- 4. Pobieranie danych
- 4.1. Pobieranie danych o linkach
- 4.2. Pobieranie danych o grupach
- 4.3. Pobieranie danych o stronach
- 4.4. Pobieranie danych o przelewach
- 4.5. Pobieranie danych o koncie
- 5. Dodawanie
- 5.1. Dodawanie linków
- 5.2. Dodawanie grup
- 5.3. Dodawanie multilinków
- 5.4. Tworzenie przelewu punktów
- 6. Usuwanie
- 6.1. Usuwanie linków
- 6.2. Usuwanie grup linków
- 6.3. Usuwanie wszystkich linków z grupy
- 6.4. Usuwanie multilinków
- 6.5. Anulowanie przelewu punktów
- 7. Edycja
- 7.1. Edycja grupy
- 7.2. Edycja linku
- 8. Przenoszenie
- 8.1. Przenoszenie linku
Wprowadzenie
Korzystanie z API polega na wysyłaniu metodą POST danych do serwera GotLink, w odpowiedzi otrzymujemy dane o których zapytanie wysyłaliśmy lub komunikat błędu w przypadku niepowodzenia. Korzystamy z kodowania "UTF-8".Pola "username" oraz "password" to odpowiednio nazwa użytkownika oraz hasło w serwisie GotLink.pl.
Pole "action" określa rodzaj wykonywanej akcji (np. pobieranie danych » "get").
Pole "type" określa rodzaj danych o jakie odpytujemy (np. linki » "links").
Uwaga! Jeśli nie chcesz przesyłać hasła w postaci jawnej, udostępniliśmy możliwość przesyłania samego wyniku funkcji skrótu na haśle, tzn. md5(hasło). Wartość tą należy ustawić w polu "md5pass" i usunąć pole "password".
Przykładowy kod z wykorzystaniem CURLa
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'get',
'type' => 'links',
'return' => 'json');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
Zwracane wartości
Przy wysyłaniu zapytania możemy ustalić, w jakim formacie chcemy dostać odpowiedź.Na dzień dzisiejszy możliwe są 2 rodzaje:
- JSON
- Zserializowana tablica
Za wybór sposobu kodowania odpowiada pole "result" w wysyłanym zapytaniu. Możliwe wartości to: "json", "serialize".
Przykład przetworzenia odpowiedzi do tablicy asocjacyjnej w PHP
//zmienna $response to odpowiedź serwera na zapytanie (patrz przykład 1)
//w przypadku wyboru danych w formacie "json", aby uzyskać tablicę asocjacyjną
$response = json_decode($response, true);
//w przypadku wyboru danych w formacie "serialize", aby uzyskać tablicę asocjacyjną
$response = unserialize($response);
Obsługa błędów
Gdy zapytanie zakończy się pomyślnie, w polu "result" będzie zawarty wynik, np. lista linków. W przypadku błędu, w polu "error" będziemy mieli komunikat błędu.Sprawdzenie błędów oraz wyświetlenie odpowiedzi
if (isset($response['error'])) {
//obsługa błędu
die($response['error']);
} else {
//wyświetlenie danych
var_dump($response['result']);
}
Pobieranie danych
Aby pobrać dane należy użyc parametru "action" i ustawić go na wartość "get".Pobieranie danych o linkach
Aby pobrać dane o linkach należy użyc parametru "type" i ustawić go na wartość "links".Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"group" | Określa numer grupy, z której chcemy pobrać informacje o linkach | id grupy | ID grupy, której linki chcemy pobrać | Brak wartości oznacza, że zostaną pobrane wszystkie linki z danego konta |
"order" | Określa rodzaj sortowania | "add_date" | sortowanie wg. daty dodania | "add_date" |
"url" | sortowanie wg. urla | |||
"anchor" | sortowanie wg. anchora | |||
"points" | sortowanie wg. punktów | |||
"order_type" | Określa kierunek sortowania | "asc" | sortowanie rosnąco | "asc" |
"desc" | sortowanie malejąco |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'get',
'type' => 'links',
'return' => 'json',
'order' => 'points',
'order_type' => 'desc',
'group' => '22');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W odpowiedzi otrzymujemy listę rekordów. Każdy rekord zawiera następujące pola:
- "id" - identyfikator linku
- "group_id" - identyfikator grupy
- "add_date" - data dodania linku w formacie UNIX_TIMESTAMP
- "url" - adres URL
- "anchor" - anchor linku
- "title" - title linku
- "text_before" - tekst przed
- "text_after" - tekst po
- "points" - liczba punktów przydzielona na link
- "position" - aktualna pozycja w wyszukiwarce (wartość 0 oznacza brak danych, wartość 127 oznacza pozycję poza pierwszą 100)
- "multilink" - określa czy to jest link czy mutlilink (0 => link, 1 => multilink)
- "lcount" - całkowita liczba pobrań danego linku
Pobieranie danych o grupach
Aby pobrać dane o grupach należy użyc parametru "type" i ustawić go na wartość "groups".Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"order" | Określa rodzaj sortowania | "id" | sortowanie wg. id | "add_date" |
"name" | sortowanie wg. nazwy | |||
"points" | sortowanie wg. punktów | |||
"order_type" | Określa kierunek sortowania | "asc" | sortowanie rosnąco | "asc" |
"desc" | sortowanie malejąco |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'get',
'type' => 'groups',
'return' => 'json',
'order' => 'id',
'order_type' => 'asc');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W odpowiedzi otrzymujemy listę rekordów. Każdy rekord zawiera następujące pola:
- "id" - identyfikator grupy
- "name" - nazwa grupy
- "points" - liczba punktów przydzielonych na grupę
Pobieranie danych o stronach
Aby pobrać dane o stronach należy użyc parametru "type" i ustawić go na wartość "sites".Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"order" | Określa rodzaj sortowania | "id" | sortowanie wg. id | "time_added" |
"site_url" | sortowanie wg. adresu | |||
"pagerank" | sortowanie wg. pageranku | |||
"time_added" | sortowanie wg. daty dodania | |||
"site" | sortowanie wg. site | |||
"points" | sortowanie wg. punktów | |||
"points_ip" | sortowanie wg. punktów za unikalne ip | |||
"points_age" | sortowanie wg. punktów za staż domeny | |||
"outgoing" | sortowanie wg. ilości linków wychodzących | |||
"backlink" | sortowanie wg. wartości BL | |||
"points_main" | sortowanie wg. bonusu za domenę główną | |||
"time_update" | sortowanie wg. ostatniej aktualizacji | |||
"order_type" | Określa kierunek sortowania | "asc" | sortowanie rosnąco | "asc" |
"desc" | sortowanie malejąco | |||
"limit" | Liczba wyników | wartość liczbowa | liczba wyników zwróconych z API (musi być większa od 0) | wszystkie |
"page" | Strona wyników | wartość liczbowa | strona wyników zwróconych z API (musi być większa od 0) | 1 |
"fields" | Określa pola, które chcemy pobrać | wybrane nazwy pól, oddzielone przecinkami | przykładowo "id,site_url" zwróci nam tylko id strony w systemie oraz adres url | brak |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'get',
'type' => 'sites',
'return' => 'json',
'fields' => 'id,site_url',
'limit' => '5',
'page' => '2',
'order' => 'site',
'order_type' => 'desc');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W odpowiedzi otrzymujemy listę rekordów. Każdy rekord zawiera następujące pola:
- "id" - identyfikator strony
- "site_url" - adres URL strony
- "pagerank" - pagerank
- "time_added" - data dodania
- "site" - wartość SITE
- "type" - typ strony (strony zwykłe bądź erotyka)
- "category" - numer kategorii (w przypadku strony zwykłych)
- "points" - liczba punktów za domenę
- "points_ip" - liczba punktów za unikalne IP domeny
- "points_main" - bonus za domenę główną
- "points_age" - bonus za staż domeny
- "show_links" - liczba wyświetlanych linków na domenie
- "show_texts" - pokazywanie tekstu przed/po (1 => tak, 0 => nie)
- "activated" - czy strona aktywna (0 => nieaktywna, 1 => aktywna, 2 => zbanowana)
- "outgoing" - ilość linków wychodzących z domeny (0 oznacza brak danych, 255 oznacza ponad 250 linków wychodzących)
- "backlink" - wartość Backlink
- "time_update" - ostatnia aktualizacja
Pobieranie danych o przelewach
Aby pobrać dane o przelewach należy użyc parametru "type" i ustawić go na wartość "transfers".Oprócz tego mamy dodatkowe opcjonalne parametry, które zostały przedstawione w tabeli poniżej.
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"order" | Określa rodzaj sortowania | "id" | sortowanie wg. id | "id" |
"title" | sortowanie wg. nazwy | |||
"points" | sortowanie wg. punktów | |||
"send_date" | sortowanie wg. daty wykonania przelewu | |||
"cancel_date" | sortowanie wg. daty zakończenia przelewu | |||
"nick" | sortowanie wg. nazwy odbiorcy | |||
"order_type" | Określa kierunek sortowania | "asc" | sortowanie rosnąco | "asc" |
"desc" | sortowanie malejąco |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'get',
'type' => 'transfers',
'return' => 'json',
'order' => 'cancel_date',
'order_type' => 'asc');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W odpowiedzi otrzymujemy dwie tablice ("in" oraz "out"), które zawierają listy przelewów odpowiednio przychodzących oraz wychodzących. Każdy rekord na liście zawiera następujące pola:
- "id" - identyfikator przelewu
- "title" - nazwa przelewu
- "points" - liczba przelanych punktów
- "send_date" - data wykonania przelewu w formacie UNIX_TIMESTAMP
- "cancel_date" - data zakończenia przelewu w formacie UNIX_TIMESTAMP (0 => przelew bezterminowy)
- "nick" - nazwa odbiorcy/nadawcy
Pobieranie danych o koncie
Aby pobrać dane o naszym koncie należy użyc parametru "type" i ustawić go na wartość "account".Pobranie informacji o koncie
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'get',
'type' => 'account',
'return' => 'json');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W odpowiedzi otrzymujemy rekord zawierący następujące pola:
- "user_nick" - nazwa użytkownika
- "user_mail" - adres email
- "register_date" - data rejestracji w formacie UNIX_TIMESTAMP
- "points_domains" - liczba punktów za dodane domeny
- "points_partners" - liczba punktów z partnerów
- "points_transfers" - liczba punktów z przelewów (wartość ujemna oznacza, że mamy przelewy wychodzące)
- "points_ip" - liczba punktów za uniklane IP domeny
- "points_age" - liczba punktów za staż domen
- "points_main" - liczba punktów za domeny główne
- "points_autolinker" - punkty pobrane za autolinkowanie
- "points_sum" - suma punktów
- "points_used" - punkty użyte na linki
- "points_left" - wolne punkty na koncie
Dodawanie
Aby dodawać dane należy użyc parametru "action" i ustawić go na wartość "add".Dodawanie linków
Aby dodać nowy link należy użyc parametru "type" i ustawić go na wartość "links".Lista parametrów przy dodawaniu linków:
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"link_type" | Kategoria główna strony | normal | kategorie zwykłe | parametr wymagany |
"erotic" | strony erotyczne | |||
"bets" | strony hazardowe | |||
"category" | Kategoria strony | "1" | kategoria: Gry | parametr wymagany w przypadku wyboru kategorii głównej "normal" |
"2" | kategoria: Handel, Biznes, Ekonomia | |||
"3" | kategoria: Internet i Komputery | |||
"4" | kategoria: Katalogi Stron i Fora | |||
"5" | kategoria: Kultura i Sztuka | |||
"6" | kategoria: Loga, Dzwonki, Sms | |||
"7" | kategoria: Motoryzacja | |||
"8" | kategoria: Nauka, Edukacja, Przyroda | |||
"9" | kategoria: Media, Polityka, Społeczeństwo | |||
"10" | kategoria: Obcojęzyczne | |||
"11" | kategoria: Rozrywka i Hobby | |||
"12" | kategoria: Turystyka, Sport, Zdrowie | |||
"13" | kategoria: Inne | |||
"group" | Grupa, do której zostanie dodany link | INT | id grupy | parametr wymagany |
"anchor" | Anchor | STRING | anchor linku | parametr wymagany |
"url" | Url | STRING | url linku | parametr wymagany |
"title" | Title | STRING | title linku | parametr opcjonalny |
"before" | Tekst przed linkiem | STRING | tekst przed linkiem | parametr opcjonalny |
"after" | Tekst po linku | STRING | tekst po linku | parametr opcjonalny |
"priority" | Priorytet | 1-10 | priorytet linku | 5 |
"bold" | Pogrubienie | 0-100 | określa procent linków, które będą pogrubione | 0 |
"stats" | Statystyki | "1" | sprawdzanie pozycji dla wybranego linku | parametr opcjonalny |
"nofollow" | Parametr nofollow | 0-100 | określa procent linków, które mają atrybut rel="nofollow" | 0 |
"delete_after" | Usuń po X pobraniach | INT | jeśli ustawiona jest wartość, link zostanie usunięty po określonej ilości pobrań | parametr opcjonalny |
"rotate_days" | Rotacja kategorii - liczba dni | 1-10 | określa co ile dni ma się zmieniać kategoria linku | parametr opcjonalny |
"rotate_category" | Rotacja kategorii - lista kategorii | zobacz dostępne kategorie przy parametrze "category" | lista kategorii, które będą sie zmieniać, oddzielone przecinkiem np "1,4,5" | parametr opcjonalny |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'add',
'type' => 'links',
'link_type' => 'normal',
'category' => '13',
'group' => '69',
'anchor' => 'system wymiany linków',
'url' => 'www.gotlink.pl',
'title' => 'system wymiany linków',
'before' => 'Najlepszy',
'after' => 'w Polsce.',
'priority' => '7',
'bold' => '50',
'stats' => '1',
'nofollow' => '5');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W przypadku sukcesu, w odpowiedzi dostajemy ID dodanego linku.
Dodawanie grup
Aby utworzyć nową grupę należy użyc parametru "type" i ustawić go na wartość "groups".Lista parametrów przy dodawaniu grupy:
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"name" | Nazwa grupy | STRING | nazwa tworzonej grupy | parametr wymagany |
"points" | Liczba punktów przypisanych do grupy | INT | liczba punktów | parametr opcjonalny, domyślnie 0 |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'add',
'type' => 'groups',
'name' => 'Nowa grupa z API',
'points' => '10000');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W przypadku sukcesu, w odpowiedzi dostajemy ID utworzonej właśnie grupy.
Dodawanie multilinków
Aby dodać nowy multilink należy użyc parametru "type" i ustawić go na wartość "multilinks".Lista parametrów przy dodawaniu multilinków:
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"link_type" | Kategoria główna strony | normal | kategorie zwykłe | parametr wymagany |
erotic | strony erotyczne | |||
"category" | Kategoria strony | Lista kategorii w dziale dodawanie linków | parametr wymagany w przypadku wyboru kategorii głównej "normal" |
|
"group" | Grupa, do której zostanie dodany multilink | INT | id grupy | parametr wymagany |
"anchors" | Lista anchorów | STRING | anchory oddzielone znakiem nowej linii "\n" | parametr wymagany |
"urls" | Adresy url | STRING | adresy url oddzielone znakiem nowej linii "\n" | parametr wymagany |
"first_change" | Zmieniaj najpierw | anchor | najpierw anchor linku, potem url | parametr wymagany |
url | najpierw url, potem anchor | |||
both | wiązania stałe (liczba anchorów musi być równa liczbie urli) | |||
random | losowa zmiana url i anchora | |||
"change_interval" | Co minimum ile pobrań zmiana linku | INT | określa minimalną ilość pobrań, po której następuje zmiana linku (minimum 10 pobrań) | parametr wymagany |
"text_before" | Tekst przed linkiem | STRING | tekst przed linkiem | parametr opcjonalny |
"text_after" | Tekst po linku | STRING | tekst po linku | parametr opcjonalny |
"priority" | Priorytet | 1-10 | priorytet linku | 5 |
"bold" | Pogrubienie | 0-100 | określa procent linków, które będą pogrubione | 0 |
"nofollow" | Parametr nofollow | 0-100 | określa procent linków, które mają atrybut rel="nofollow" | 0 |
"delete_after" | Usuń po X pobraniach | INT | jeśli ustawiona jest wartość, link zostanie usunięty po określonej ilości pobrań | parametr opcjonalny |
"name" | Nazwa multilinku | STRING | nazwa tworzonego multilinku | parametr opcjonalny |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'add',
'type' => 'multilinks',
'link_type' => 'normal',
'category' => '13',
'group' => '69',
'anchors' => implode("\n", array('system wymiany linków', 'swl', 'wymiana linkami')),
'urls' => 'www.gotlink.pl',
'first_change' => 'anchor',
'change_interval' => '25',
'priority' => '7',
'bold' => '50');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W przypadku sukcesu, w odpowiedzi dostajemy ID dodanego linku.
Tworzenie przelewu punktów
Aby stworzyć nowy przelew punktów należy użyc parametru "type" i ustawić go na wartość "transfers".Lista parametrów przy tworzeniu nowego przelewu:
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"receiver" | Nazwa odbiorcy | STRING | nazwa użytkownika w systemie GotLink.pl | parametr wymagany |
"points" | Liczba przelewanych punktów | INT | liczba punktów | parametr wymagany |
"title" | Tytuł przelewu | STRING | tytuł przelewu | parametr wymagany |
"cancel_date" | Data anulowania przelewu | STRING | data w formacie DD-MM-RRRR | przelew bezterminowy |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'add',
'type' => 'transfers',
'receiver' => 'Zbyszek',
'title' => 'Transfer z API',
'cancel_date' => '01-01-2013',
'points' => '50000');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
W przypadku sukcesu, w odpowiedzi dostajemy ID utworzonego transferu.
Usuwanie
Aby usuwać dane należy użyc parametru "action" i ustawić go na wartość "delete".Usuwanie linków
Aby usunąć link należy użyc parametru "type" i ustawić go na wartość "links".Dodatkowo parametr "id" określa ID linku, który chcemy usunąć. Możemy usunąć więcej niż jeden link jednym zapytaniem, aby tego dokonać należy poszczególne ID linków oddzielić przecinkiem np. "54,58,89". W jednym zapytaniu można usunąć maksymalnie 50 linków.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Usuwanie grup linków
Aby usunąć grupę oraz linki znajdujące się w niej należy użyc parametru "type" i ustawić go na wartość "groups".Dodatkowo parametr "id" określa ID grupy, którą chcemy usunąć.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Usuwanie wszystkich linków z grupy
Aby usunąć wszystkie linki znajdujące się w grupie należy użyc parametru "type" i ustawić go na wartość "groups", parametr "action" należy ustawić na wartość "clear". Jako parametr "id" podajemy numer grupy.W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Usuwanie multilinków
Multilinki usuwa się używając opisu od kasowania linków, wystarczy podać id usuwanego multilinku.Anulowanie przelewu punktów
Aby anulować przelew punktów należy użyc parametru "type" i ustawić go na wartość "transfers".Dodatkowo parametr "id" określa ID przelewu, który chcemy anulować
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Edycja
Aby edytować dane należy użyc parametru "action" i ustawić go na wartość "edit".Edycja grupy
Aby edytować grupę należy ustawić parametr "type" na wartość "groups".Dodatkowo parametr "id" określa ID grupy, którą chcemy modyfikować. Parametr "points" określa nową ilość punktów przypisanych do grupy.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Edycja linku
Aby edytować link należy ustawić parametr "type" na wartość "links".Parametr "id" określa ID linku, który chcemy zmodyfikować.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".
Lista parametrów:
Nazwa parametru | Opis parametru | Możliwa wartość | Opis wartości | Domyślnie |
---|---|---|---|---|
"id" | ID linku | INT | identyfikator linku w systemie GotLink.pl | parametr wymagany |
"priority" | Priorytet | 1-10 | priorytet linku | parametr opcjonalny |
"bold" | Pogrubienie | 0-100 | określa procent linków, które będą pogrubione | parametr opcjonalny |
"nofollow" | Parametr nofollow | 0-100 | określa procent linków, które mają atrybut rel="nofollow" | parametr opcjonalny |
$data = array('username' => 'Login_Usera',
'password' => 'Hasło',
'action' => 'edit',
'type' => 'links',
'id' => '12345',
'priority' => '7',
'bold' => '65');
$ch = curl_init('http://www.gotlink.pl/gotlink-api/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($ch);
curl_close($ch);
Przenoszenie
Aby przenieść wybrane dane należy użyc parametru "action" i ustawić go na wartość "move".Przenoszenie linku
Aby przenieść link należy ustawić parametr "type" na wartość "links".Dodatkowo parametr "id" określa ID linku, który chcemy przenieść, a parametr "group" określa ID grupy do której przeniesiony zostanie link.
W przypadku sukcesu, w odpowiedzi dostajemy komunikat "OK".