Stan usługi
Czy API działa (bez tokenu).
Stan usługi
GET /
tylko alleelimit: read
Bez tokenu. Do monitoringu: 200 i bieżący czas (UTC).
Zgodność: tylko allee.
Uwierzytelnienie: brak.
Odpowiedzi
200 API działa. · ServiceStatus
status string zawszeokapi string zawszealleeczas string · date-time zawszeBieżący czas serwera (UTC).
Błędy
| HTTP | Kod | Znaczenie |
|---|---|---|
| 500 | INTERNAL_ERROR | Błąd serwera allee. |
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/" \
-H "Accept: application/vnd.allegro.public.v1+json" \
-w '\nHTTP %{http_code}\n'<?php
// allee API: GET / (PHP 8, rozszerzenie curl)
$base = getenv('ALLEE_API_URL') ?: 'https://api.allee.pl';
$ch = curl_init($base . '/');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Accept: application/vnd.allegro.public.v1+json',
],
CURLOPT_RETURNTRANSFER => true,
]);
$odp = curl_exec($ch);
echo 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), "\n", $odp, "\n";# allee API: GET / (Python 3, biblioteka requests)
import os
import requests
BASE = os.environ.get("ALLEE_API_URL", "https://api.allee.pl")
headers = {
"Accept": "application/vnd.allegro.public.v1+json",
}
r = requests.request("GET", BASE + "/", headers=headers, timeout=60, allow_redirects=False)
print("HTTP", r.status_code)
print(r.text)// allee API: GET / (Node.js 18+, wbudowany fetch; plik .mjs)
const BASE = process.env.ALLEE_API_URL ?? "https://api.allee.pl";
const res = await fetch(`${BASE}/`, {
method: "GET",
headers: {
"Accept": "application/vnd.allegro.public.v1+json",
},
redirect: "manual",
});
console.log("HTTP", res.status);
console.log(await res.text());// allee API: GET / (C#, .NET 8+, HttpClient)
using System.Net.Http.Headers;
using System.Text;
var baseUrl = Environment.GetEnvironmentVariable("ALLEE_API_URL") ?? "https://api.allee.pl";
using var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });
using var req = new HttpRequestMessage(new HttpMethod("GET"), baseUrl + "/");
req.Headers.Accept.ParseAdd("application/vnd.allegro.public.v1+json");
using var res = await http.SendAsync(req);
Console.WriteLine($"HTTP {(int)res.StatusCode}");
Console.WriteLine(await res.Content.ReadAsStringAsync());// allee API: GET / (Java 11+, java.net.http; uruchom: java Main.java)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
String base = System.getenv().getOrDefault("ALLEE_API_URL", "https://api.allee.pl");
HttpRequest req = HttpRequest.newBuilder(URI.create(base + "/"))
.header("Accept", "application/vnd.allegro.public.v1+json")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();
HttpResponse<String> res = http.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println("HTTP " + res.statusCode());
System.out.println(res.body());
}
}// allee API: GET / (Go 1.20+, net/http; uruchom: go run main.go)
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
base := os.Getenv("ALLEE_API_URL")
if base == "" {
base = "https://api.allee.pl"
}
req, err := http.NewRequest("GET", base+"/", nil)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/vnd.allegro.public.v1+json")
klient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}
res, err := klient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
dane, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
fmt.Println("HTTP", res.StatusCode)
fmt.Println(string(dane))
}application/vnd.allegro.public.v1+json{
"status": "ok",
"api": "allee",
"czas": "2026-11-10T11:10:02Z"
}Specyfikacja OpenAPI 3.1
GET /openapi.json
tylko alleelimit: read
Ten dokument — opis wszystkich operacji, schematów, błędów, zakresów i limitów w formacie OpenAPI 3.1 (z przykładami kodu x-codeSamples w 7 językach). Zaimportuj go do Postmana, Insomnii albo generatora klientów (openapi-generator).
Bez tokenu. ETag + If-None-Match → 304; gzip, gdy klient go przyjmuje. Ten sam plik jest w portalu dla deweloperów.
Zgodność: tylko allee.
Uwierzytelnienie: brak.
Odpowiedzi
200 Specyfikacja. · object
304 Bez zmian (If-None-Match).
Błędy
| HTTP | Kod | Znaczenie |
|---|---|---|
| 429 | TOO_MANY_REQUESTS | Przekroczony limit (minutowy, grupy operacji albo IP). |
| 500 | INTERNAL_ERROR | Błąd serwera allee. |
| 503 | NOT_DEPLOYED | Funkcja jeszcze nie uruchomiona (np. sandbox, wsady). |
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/openapi.json" \
-H "Accept: application/json" \
-o openapi.json -w 'HTTP %{http_code}\n'<?php
// allee API: GET /openapi.json (PHP 8, rozszerzenie curl)
$base = getenv('ALLEE_API_URL') ?: 'https://api.allee.pl';
$ch = curl_init($base . '/openapi.json');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Accept: application/json',
],
CURLOPT_RETURNTRANSFER => true,
]);
$odp = curl_exec($ch);
$kod = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($kod === 200) file_put_contents('openapi.json', $odp);
echo 'HTTP ', $kod, "\n";# allee API: GET /openapi.json (Python 3, biblioteka requests)
import os
import requests
BASE = os.environ.get("ALLEE_API_URL", "https://api.allee.pl")
headers = {
"Accept": "application/json",
}
r = requests.request("GET", BASE + "/openapi.json", headers=headers, timeout=60, allow_redirects=False)
if r.status_code == 200:
with open("openapi.json", "wb") as f:
f.write(r.content)
print("HTTP", r.status_code)// allee API: GET /openapi.json (Node.js 18+, wbudowany fetch; plik .mjs)
import { readFile, writeFile } from "node:fs/promises";
const BASE = process.env.ALLEE_API_URL ?? "https://api.allee.pl";
const res = await fetch(`${BASE}/openapi.json`, {
method: "GET",
headers: {
"Accept": "application/json",
},
redirect: "manual",
});
if (res.status === 200) await writeFile("openapi.json", Buffer.from(await res.arrayBuffer()));
console.log("HTTP", res.status);// allee API: GET /openapi.json (C#, .NET 8+, HttpClient)
using System.Net.Http.Headers;
using System.Text;
var baseUrl = Environment.GetEnvironmentVariable("ALLEE_API_URL") ?? "https://api.allee.pl";
using var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });
using var req = new HttpRequestMessage(new HttpMethod("GET"), baseUrl + "/openapi.json");
req.Headers.Accept.ParseAdd("application/json");
using var res = await http.SendAsync(req);
if ((int)res.StatusCode == 200) File.WriteAllBytes("openapi.json", await res.Content.ReadAsByteArrayAsync());
Console.WriteLine($"HTTP {(int)res.StatusCode}");// allee API: GET /openapi.json (Java 11+, java.net.http; uruchom: java Main.java)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
String base = System.getenv().getOrDefault("ALLEE_API_URL", "https://api.allee.pl");
HttpRequest req = HttpRequest.newBuilder(URI.create(base + "/openapi.json"))
.header("Accept", "application/json")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();
HttpResponse<Path> res = http.send(req, HttpResponse.BodyHandlers.ofFile(Path.of("openapi.json")));
System.out.println("HTTP " + res.statusCode());
}
}// allee API: GET /openapi.json (Go 1.20+, net/http; uruchom: go run main.go)
package main
import (
"fmt"
"net/http"
"os"
)
func main() {
base := os.Getenv("ALLEE_API_URL")
if base == "" {
base = "https://api.allee.pl"
}
req, err := http.NewRequest("GET", base+"/openapi.json", nil)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
klient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}
res, err := klient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
if res.StatusCode == 200 {
f, err := os.Create("openapi.json")
if err != nil {
panic(err)
}
defer f.Close()
if _, err := f.ReadFrom(res.Body); err != nil {
panic(err)
}
}
fmt.Println("HTTP", res.StatusCode)
}application/json; charset=utf-8(plik openapi.json: 2602539 B, application/json; charset=utf-8)Dokumentacja (przekierowanie)
GET /docs
tylko alleelimit: read
301 na portal dla deweloperów: https://allee.pl/dla-deweloperow/
Zgodność: tylko allee.
Uwierzytelnienie: brak.
Odpowiedzi
301 Przekierowanie na portal.
Błędy
| HTTP | Kod | Znaczenie |
|---|---|---|
| 500 | INTERNAL_ERROR | Błąd serwera allee. |
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/docs" \
-H "Accept: text/html" \
-w '\nHTTP %{http_code}\n'<?php
// allee API: GET /docs (PHP 8, rozszerzenie curl)
$base = getenv('ALLEE_API_URL') ?: 'https://api.allee.pl';
$ch = curl_init($base . '/docs');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Accept: text/html',
],
CURLOPT_RETURNTRANSFER => true,
]);
$odp = curl_exec($ch);
echo 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), "\n", $odp, "\n";# allee API: GET /docs (Python 3, biblioteka requests)
import os
import requests
BASE = os.environ.get("ALLEE_API_URL", "https://api.allee.pl")
headers = {
"Accept": "text/html",
}
r = requests.request("GET", BASE + "/docs", headers=headers, timeout=60, allow_redirects=False)
print("HTTP", r.status_code)
print(r.text)// allee API: GET /docs (Node.js 18+, wbudowany fetch; plik .mjs)
const BASE = process.env.ALLEE_API_URL ?? "https://api.allee.pl";
const res = await fetch(`${BASE}/docs`, {
method: "GET",
headers: {
"Accept": "text/html",
},
redirect: "manual",
});
console.log("HTTP", res.status);
console.log(await res.text());// allee API: GET /docs (C#, .NET 8+, HttpClient)
using System.Net.Http.Headers;
using System.Text;
var baseUrl = Environment.GetEnvironmentVariable("ALLEE_API_URL") ?? "https://api.allee.pl";
using var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });
using var req = new HttpRequestMessage(new HttpMethod("GET"), baseUrl + "/docs");
req.Headers.Accept.ParseAdd("text/html");
using var res = await http.SendAsync(req);
Console.WriteLine($"HTTP {(int)res.StatusCode}");
Console.WriteLine(await res.Content.ReadAsStringAsync());// allee API: GET /docs (Java 11+, java.net.http; uruchom: java Main.java)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
String base = System.getenv().getOrDefault("ALLEE_API_URL", "https://api.allee.pl");
HttpRequest req = HttpRequest.newBuilder(URI.create(base + "/docs"))
.header("Accept", "text/html")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();
HttpResponse<String> res = http.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println("HTTP " + res.statusCode());
System.out.println(res.body());
}
}// allee API: GET /docs (Go 1.20+, net/http; uruchom: go run main.go)
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
base := os.Getenv("ALLEE_API_URL")
if base == "" {
base = "https://api.allee.pl"
}
req, err := http.NewRequest("GET", base+"/docs", nil)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "text/html")
klient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}
res, err := klient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
dane, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
fmt.Println("HTTP", res.StatusCode)
fmt.Println(string(dane))
}text/html; charset=UTF-8(0 B: text/html; charset=UTF-8)