Documentar o Swagger das APIs

[ThierryAJean]

Necessário para Socialme / Impacto / Ruralmobi

[0e1]

Como atualizar a versão do PostgREST

cd /var/gits/_a4a/WS/src
sudo docker-compose pull
sudo docker-compose up -d --force-recreate

Como atualizar o Swagger:

REPO="swagger-api/swagger-ui"
LATEST_TAG=$(curl -s "https://api.github.com/repos/$REPO/releases/latest" | jq -r .tag_name)
ZIP_URL="https://codeload.github.com/${REPO}/zip/refs/tags/${LATEST_TAG}"
FILE_NAME="${REPO##*/}-${LATEST_TAG}.zip"
wget -q --show-progress "$ZIP_URL" -O "$FILE_NAME"
unzip -q "$FILE_NAME"
EXTRACTED_DIR=$(find . -maxdepth 1 -type d -name "swagger-ui-*" | sort | head -n 1)
INITIALIZER="$EXTRACTED_DIR/dist/swagger-initializer.js"

sed -i 's|url: .*|url: "https://api." + window.location.hostname + "/",|g' "$INITIALIZER"

rm -rf /var/gits/gridMap-draftPages/swagger
cp -rf $EXTRACTED_DIR/dist /var/gits/gridMap-draftPages/swagger

[0e1]

@ppKrauss Criar DNS para osm-codes/WS#59

[ThierryAJean]

Na documentação, destacar em link separado as mudanças de 2024 para 2025.

Teremos que passar estas novas APIs objeto do novo Swagger para Filipe/Arthur e para Laurent /França para eles se prepararem.

[ThierryAJean]

Felipe quase terminou a documentação do Swagger acrescentando alguns exemplos com algumas imagens. Peter vai terminar a documentação na Wiki para gerar o pdf para poder passar tudo para o Filipe Rocha & Socialme. Até o final de semana deve estar pronto.

[ThierryAJean]

@flipreis21 vai terminar a domcumentação com as instruções que acaba de receber do Peter na reunião. Vai fazer video e acrescentar códigos de erro

[ThierryAJean]

@ppKrauss tem que terminar em Portugues, traduzir em inglês e passar para o Laurent.