Funkciók

Funkciók

• Valós idejű szerző javaslatok gépelés közben
• MTMT azonosító ellenőrzés

API Végpontok

Valós idejű keresési javaslatokhoz használt

// API Végpontok

// 1. Szerző Javaslatok API
GET https://m2.mtmt.hu/api/author
?size=200                    // Maximális találatok száma
&depth=0                     // Csak alapinformációk
&cond=label;any;{searchTerm} // Keresés a szerző nevében
&sort=familyName,asc        // Rendezés vezetéknév és keresztnév szerint
&sort=givenName,asc         
&labelLang=hun              // Magyar címkék
&format=json                // Válasz formátum

// 2. Szerző Ellenőrzés API
GET https://m2.mtmt.hu/api/author/{mtmtId}?format=json

Keresés Implementáció

A keresés implementáció tartalmaz késleltetést a túlzott API hívások elkerülésére és valós idejű javaslatokat nyújt gépelés közben:

// Author search with debouncing
const fetchAuthorSuggestions = useCallback(
  debounce(async (input: string) => {
    if (input.length < 3) {
      setAuthorState(prev => ({ ...prev, suggestions: [] }));
      return;
    }

    const response = await fetch.authorSuggestions(input);
    if (!response.ok) throw new Error("Failed to fetch suggestions");
    
    setAuthorState(prev => ({
      ...prev,
      suggestions: response.data.content.map((item: any) => ({
        id: item.mtid,
        name: item.label
      }))
    }));
  }, 300),
  []
);

Válasz Formátum

Az API a szerző javaslatokat a következő formátumban adja vissza:

// Példa válasz a szerző javaslatok API-tól
{
  "content": [
    {
      "mtid": 10012345,
      "label": "Dr. Example Name (Department)",
      "familyName": "Example",
      "givenName": "Name",
      "auxName": "Department"
    }
  ]
}

Használati Útmutató

Hibakezelés