API | System wymiany linków GotLink.pl

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

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"
"order_type"	Określa kierunek sortowania	"desc"	sortowanie malejąco	"asc"

Pobranie listy linków z grupy 22 posortowanych wg ilości punktów 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"
"order_type"	Określa kierunek sortowania	"desc"	sortowanie malejąco	"asc"

Pobranie listy grup posortowanych wg id rosną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"
"order_type"	Określa kierunek sortowania	"desc"	sortowanie malejąco	"asc"
"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

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.

$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"
"order_type"	Określa kierunek sortowania	"desc"	sortowanie malejąco	"asc"

Pobranie listy przelewów posortowanych wg daty zakończenia rosną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

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

$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

Przykład utworzenia nowej grupy i ustawienia dla niej 10.000 punktów

$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
"link_type"	Kategoria główna strony	erotic	strony erotyczne	parametr wymagany
"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

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ń

$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

Przykład przelania użytkownikowi "Zbyszek" 50.000 punktów, z ustawieniem końca transferu na 1 styczeń 2013 roku

$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

Przykład zmiany priorytetu linku ID 12345 na 7 oraz pogrubienia na 65%

$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".