Przejdź do treści

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.json

02 · Powierzchnie integracji

Wybierz najmniejszy interfejs

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_found Użyj ścieżki opublikowanej w OpenAPI.
  • method_not_allowed Użyj metody wskazanej przez nagłówek Allow.
  • invalid_json Wyślij poprawny składniowo JSON.
  • request_body_unreadable Ponów request zakodowany jako UTF-8.
  • validation_failed Popraw pola zgodnie z InquiryRequest.
  • payload_too_large Zmniejsz rozmiar requestu.
  • unsupported_media_type Wyślij application/json.
  • rate_limited Poczekaj zgodnie z Retry-After.
  • inquiry_delivery_unavailable Spróbuj później lub skontaktuj się bezpośrednio.
  • internal_server_error Spróbuj później lub skontaktuj się z zespołem.
  • mcp_transport_error Ponó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
}

Zasoby kanoniczne

Interaktywny brief zakupowy Przewodnik dla agentów AI OpenAPI JSON Katalog API RFC 9727 Manifest serwera MCP Endpoint MCP Streamable HTTP Uwierzytelnianie Dostępność webhooków Polityka wersjonowania Pytanie o integrację lub ofertę