A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz
as_of: o quão atuais são os dados. Como funcionam os datasets.Buscar lugares
POST /sv/mitur-sv/places-search/v1 Dataset
Uma única busca sobre todo o diretório, filtrada por tipo, tema, departamento, município, idioma do guia ou inscrição no registro.
as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, page, per_page, total_pages, count e results[]: primeiro o que melhor corresponde quando há query, depois os inscritos no Registro Nacional de Turismo, depois os atualizados mais recentemente. Cada resultado traz id (o id permanente do lugar no diretório, p. ex. 2905), slug, name, kind, themes, guide_level (para guias: site, local ou national), registered (inscrito no Registro Nacional de Turismo), access (para pontos turísticos: public ou private), department, municipality, region, languages (para guias), hours, phones, emails, address, website, whatsapp, social_links, official_url (a página do lugar no site oficial de turismo) e updated_at. Os guias trazem nome, idiomas, nível e área, nunca seus contatos pessoais: phones, emails e address vêm vazios para eles.
Os resultados da busca não incluem a descrição nem as fotos de um destino. Leia-as com o endpoint El Salvador Tourism Place.
Um lugar, completo
POST /sv/mitur-sv/place/v1 Dataset
as_of, found, place_id e place, que traz tudo o que a busca retorna mais description (o texto do Ministério sobre um destino) e photos[]: cada uma com document_url (a cópia da Croma da foto, idêntica byte a byte à publicada, que continua disponível aconteça o que acontecer com o link original) e source_document_url (a foto no site oficial). Cada resultado traz id (o id permanente do lugar no diretório, p. ex. 2905), slug, name, kind, themes, guide_level (para guias: site, local ou national), registered (inscrito no Registro Nacional de Turismo), access (para pontos turísticos: public ou private), department, municipality, region, languages (para guias), hours, phones, emails, address, website, whatsapp, social_links, official_url (a página do lugar no site oficial de turismo) e updated_at. Os guias trazem nome, idiomas, nível e área, nunca seus contatos pessoais: phones, emails e address vêm vazios para eles.
Um id, slug ou link que o diretório não tem retorna
found: false com HTTP 200, não um erro.Buscar eventos
POST /sv/mitur-sv/events-search/v1 Dataset
A agenda oficial, do mais próximo ao mais distante, por intervalo de datas, departamento ou texto livre.
as_of, os filtros aplicados (com o from_date usado), total e total_is_exact, page, per_page, total_pages, count e results[], do mais próximo ao mais distante. Cada evento traz id, slug, name, start_date, end_date, venue, department, links (a página do organizador, ingressos ou uma publicação, quando a agenda os informa), official_url e updated_at.
Sem
from_date, a busca retorna os eventos que ainda não terminaram, contando a partir de hoje em El Salvador.Referência completa
Esquemas, todos os campos de resposta e um playground interativo.