REST JSON
Deterministyczny odczyt katalogu i endpoint zapytania chroniony zgodą.
Specyfikacja OpenAPI ↗Publiczne API · odczyt bez klucza
Dokumentacja deweloperska Aloha Fungi B2B
Połącz wyszukiwanie produktów, kwalifikację B2B i przekazanie zapytania za zgodą kupca z Aloha Fungi. Odczyt jest publiczny. Warunki handlowe zawsze potwierdza człowiek.
01 · Szybki start
Katalog w jednym zapytaniu
Zbiorczy katalog zawiera dane firmy, produkty, modele współpracy, artykuły edukacyjne, słownik i odnośniki do wszystkich powierzchni integracji.
Zapytanie GET, bez uwierzytelniania
curl -s https://b2b.alohafungi.pl/api/v1/catalog.json02 · Powierzchnie integracji
Wybierz najmniejszy interfejs
MCP
Narzędzia i zasoby dla asystentów obsługujących Model Context Protocol Streamable HTTP.
Manifest serwera MCP ↗Discovery
llms.txt, sitemap i katalog RFC 9727 ułatwiają znalezienie interfejsów.
Katalog API ↗03 · Referencja endpointów
Publiczny kontrakt
| Metoda | Ścieżka | Zastosowanie | Skutek uboczny |
|---|---|---|---|
| GET | /api/v1/catalog.json | Zbiorczy katalog | Brak |
| GET | /api/v1/products.json | Produkty i parametry techniczne | Brak |
| GET | /api/v1/articles.json | Indeks treści edukacyjnych | Brak |
| GET | /api/v1/faq.json | Pytania i odpowiedzi z artykułów Edukacji (PL+EN) | Brak |
| GET | /api/v1/services.json | Modele współpracy | Brak |
| GET | /api/v1/glossary.json | Terminologia B2B | Brak |
| POST | /api/v1/qualification | Kwalifikacja wymagań z dowodami | Brak |
| POST | /api/v1/zapytanie | Przekazanie zapytania | E-mail do handlowca po zgodzie |
Trzy opcjonalne pola QualificationRequest: material_basis (undecided, fruiting_body, pure_mycelium, myceliated_substrate lub combination), spec_method (tekst do 500 znaków, metoda badania dla standaryzacji) oraz allow_alternative (boolean, domyślnie true).
04 · Błędy i cykl życia
Przewidywalne błędy
Błędy REST używają RFC 9457 application/problem+json. Pole code służy do sterowania, message daje kontekst, a resolution wskazuje bezpieczny następny krok.
Wersja v1 jest aktualna
Kanoniczne ścieżki REST zaczynają się od /api/v1/. Ścieżki bez wersji pozostają aliasami kompatybilności i nie są wycofywane. Zmiany łamiące kontrakt otrzymają nową wersję główną i co najmniej 12 miesięcy zapowiedzi.
Polityka wersjonowania ↗api_endpoint_not_foundUżyj ścieżki opublikowanej w OpenAPI.method_not_allowedUżyj metody wskazanej przez nagłówek Allow.invalid_jsonWyślij poprawny składniowo JSON.request_body_unreadablePonów request zakodowany jako UTF-8.validation_failedPopraw pola zgodnie z InquiryRequest.payload_too_largeZmniejsz rozmiar requestu.unsupported_media_typeWyślij application/json.rate_limitedPoczekaj zgodnie z Retry-After.internal_server_errorSpróbuj później lub skontaktuj się z zespołem.mcp_transport_errorPonów MCP albo użyj REST API.
05 · Bezpieczeństwo i granice handlowe
Czytaj swobodnie. Działaj za zgodą.
- Nie wyciągaj z katalogu ceny, dostępności partii ani wiążących warunków handlowych.
- Wyślij zapytanie dopiero po pokazaniu kupcowi podsumowania i uzyskaniu wyraźnej zgody na kontakt.
- Zapytanie nie jest zamówieniem, rezerwacją ani zobowiązaniem finansowym.
- Informacje o składnikach służą kwalifikacji B2B. Nie są poradą medyczną ani obietnicą zdrowotną.
Minimalny payload zapytania
Firma i e-mail są wymagane. Dodaj gatunek albo opis potrzeby. consent_to_contact musi mieć wartość true.
{
"company": "Example Foods Sp. z o.o.",
"email": "buyer@example.com",
"species": "lions-mane",
"form": "water extract",
"quantity_kg": 5,
"delivery_country": "PL",
"consent_to_contact": true
}