Add Tematres endpoint

[tematres]

Hi, I'm trying to incorporate the managed vocabulary endpoint service with Tematres. Tematres has a specialized API for terminology and verb services specifically dedicated to suggesting terms (example: https://vocabularyserver.com/tbci/es/services.php?task=suggestDetails&arg=his&output=json). The Swageer example is available here: https://vocabularyserver.com/apidoc/. There are over 600 vocabularies available in Tematres (https://vocabularyserver.com/vocabularies/).

I tried to copy the Homosaurus schema, but it gives me an error, and I don't know the framework to debug the errors :/

Could someone help me? I'm not sure how to incorporate the endpoint. I'm sharing the code here:

public function getSuggestions($query)
{
$query = trim($query);
if (empty($query) {
return [];
}

try {
    $response = $this->client
        ->setUri('https://vocabularyserver.com/tbci/es/services.php',[
    'adapter' => 'Laminas\Http\Client\Adapter\Curl',
])
        ->setParameterGet([
            'task' => 'suggestDetails',
            'arg' => $query,
            'output' => 'json'
        ])
        ->send();

    if (!$response->isSuccess()) {
        return [];
    }

    // Parse the JSON response.
    $suggestions = [];
    $results = json_decode($response->getBody(), true);

    if (empty($results) || !is_array($results)) {
        return [];
    }

    foreach ($results as $result) {
        if (empty($result['value']) || empty($result['id'])) {
            continue;
        }

        $value = $result['value'];
        $id = $result['id'];
        $description = $result['description'] ?? '';

        $info = '';
        if (!empty($description)) {
            $info = $description;
        }

        $suggestions[] = [
            'value' => $value . ($info ? ' (' . $info . ')' : ''),
            'data' => [
                'uri' => $id,
                'info' => $info,
            ],
        ];
    }

    return $suggestions;

} catch (\Exception $e) {
    // Log error if needed
    return [];
}

}

[jimsafley]

What error are you getting? Follow these directions on how to retrieve error messages.

[tematres]

Hi :) thank you. I enabled debugging and this is the message: "Uncaught SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data"

But I do not know how to access to the JSON feed into omeka-s to see the line of the json data.

We use this to perform the request:

$response = $this->client
        ->setUri('https://vocabularyserver.com/tbci/es/services.php')
        ->setParameterGet([
                'task' => 'suggestDetails',
                'arg' => $query,
                'output' => 'json'
            ])
            ->send();

        if (!$response->isSuccess()) {
            return [];
        }

And this is the standard response to request: https://vocabularyserver.com/tbci/es/services.php?task=suggestDetails&arg=his&output=json

Can you help me to found the problem? thank you in advance :)

[jimsafley]

You have to decode the response body, like this:

$results = json_decode($response->getBody(), true);

Then you can build the suggestions array and return it.

[tematres]

Hi .... but I do that :/ Here the complete function

public function getSuggestions($query, $lang = null)
    {
        $response = $this->client
        ->setUri('https://vocabularyserver.com/tbci/es/services.php')
        ->setParameterGet([
                'task' => 'suggestDetails',
                'arg' => $query,
                'output' => 'json'
            ])
            ->send();

        if (!$response->isSuccess()) {
            return [];
        }


        // Parse the JSON response.
        $suggestions = [];
        $results = json_decode($response->getBody(), true);

            foreach ($results as $result) {
            if (empty($result['value']) || empty($result['id'])) {
                continue;
            }

            $value = $result['value'];
            $id = $result['id'];
            $info = $result['id'];

            $suggestions[] = [
                'value' => $value,
                'data' => [
                    'uri' => $id,
                    'info' => $info,
                ],
            ];
        }
        
        return $suggestions;
    }

[jimsafley]

When entering a value, what does ValueSuggest's proxy return? Look in your browser's dev tool. You should see a request for proxy?query=<query>.... What does the response look like?