API

Twórz krótkie linki i zarządzaj nimi ze skryptów i aplikacji. API jest darmowe. Utwórz klucz w swoim panelu w sekcji Klucze API, a potem wysyłaj go jako token bearer.

Uwierzytelnianie

Authorization: Bearer gz_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Klucze pokazujemy tylko raz. Traktuj je jak hasła: każdy, kto ma Twój klucz, może tworzyć i edytować linki na Twoim koncie. Klucz, który wyciekł, unieważnij w panelu.

Limity

60 żądań na minutę na klucz.
500 nowych linków dziennie na konto.
Adresy docelowe sprawdzamy w Google Safe Browsing i na naszej liście blokad. Inne skracacze linków nie mogą być adresem docelowym.

Utwórz link

curl -X POST https://gozi.to/api/my/links \
  -H "Authorization: Bearer $GOZI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/launch", "code": "launch"}'

code jest opcjonalny (4–32 litery, cyfry, - lub _). Pomiń go, aby dostać losowy 7-znakowy kod. Odpowiedź 201:

{
  "link": {
    "code": "launch",
    "shortUrl": "https://gozi.to/launch",
    "url": "https://example.com/launch",
    "status": "active",
    "statusReason": null,
    "custom": true,
    "createdAt": 1790000000000,
    "expiresAt": null
  }
}

Lista linków

GET /api/my/links?limit=25&cursor=<nextCursor>&q=<search>&clicks=1

Od najnowszych. Przekaż nextCursor z poprzedniej strony, aby pobrać kolejną. clicks=1 dodaje liczbę kliknięć ludzi od początku.

Pobierz, edytuj, usuń

GET    /api/my/links/{code}
PATCH  /api/my/links/{code}   {"url": "https://new.example"}  or  {"status": "disabled" | "active"}
DELETE /api/my/links/{code}

Statystyki

GET /api/my/links/{code}/stats

Zwraca kliknięcia ludzi z ostatnich 90 dni i od początku, kliknięcia dzienne oraz najczęstsze kraje, źródła odesłań, urządzenia, przeglądarki i systemy operacyjne. Boty i podglądy linków (Slack, WhatsApp i podobne) liczymy osobno w botClicks. Wyniki są buforowane przez około 5 minut.

Błędy

Błędy używają kodów statusu HTTP i treści JSON:

{ "error": { "code": "slug_taken", "message": "That custom link is already taken." } }

400 nieprawidłowe dane (invalid_url, invalid_slug, …)
401 brakujący, nieprawidłowy lub unieważniony klucz
409 własny link jest już zajęty
422 adres docelowy niedozwolony (destination_blocked)
429 osiągnięto limit częstotliwości lub limit dzienny

Opis wszystkich punktów końcowych w formacie maszynowym znajdziesz pod adresem /openapi.json.