Documentação da API

X-Api-Key: SUA_CHAVE

{"lOk": true}

curl -H "X-Api-Key: SUA_CHAVE" \
     "https://api.qtux.com.br/geocep/localizar?sCep=13216340&sNum=161"

{
  "lOk": true, "iQtd": 1, "iAchou": 1,
  "aRet": [{
    "iSeq": 0,
    "sCep": "13216340", "sNum": "161",
    "lOk": true,
    "nLat": -23.17516, "nLon": -46.87214,
    "sPrec": "numero",
    "sLogr": "RUA HERMENEGILDO MARTINELI",
    "sLocal": "JARDIM DA FONTE",
    "iCodMun": 3525904, "sMun": "Jundiaí", "sUf": "SP",
    "lAmbig": false,
    "sEnd": "RUA HERMENEGILDO MARTINELI, 161, JARDIM DA FONTE, Jundiaí - SP, 13216-340",
    "sMapa": "https://www.google.com/maps/search/?api=1&query=-23.17516,-46.87214",
    "iOrdem": 1
  }]
}

{
  "aEnd": [
    {"sCep": "13216-340", "sNum": "161"},
    {"sCep": "13213073",  "sNum": "177"},
    {"sCep": "90010150",  "sNum": "1200", "sLogr": "opcional"}
  ]
}

{
  "lOtim": true, "lVolta": true,
  "aEnd": [
    {"sCep": "13216340", "sNum": "161"},   // base: saida e chegada
    {"sCep": "13202020", "sNum": "235"},
    {"sCep": "13203000", "sNum": "221"},
    {"sCep": "13206010", "sNum": "2641"},
    {"sCep": "13208050", "sNum": "318"},
    {"sCep": "13209000", "sNum": "873"},
    {"sCep": "13211000", "sNum": "575"},
    {"sCep": "13213073", "sNum": "177"},
    {"sCep": "13215003", "sNum": "193"}
  ]
}

{
  "lOk": true, "iQtd": 9, "iAchou": 9,
  "lOtim": true, "lVolta": true,
  "sCusto": "rua",
  "nKm": 31.8, "nMin": 58.4,
  "aOrdem": [0, 7, 6, 5, 4, 3, 2, 1, 8, 0],
  "aMapa": ["https://www.google.com/maps/dir/?api=1&travelmode=driving&origin=...&waypoints=..."],
  "aRet": [ /* um item por endereco enviado, com iOrdem */ ]
}

{
  "oOrig": {"nLat": -23.18989, "nLon": -46.88723},
  "oFim":  {"nLat": -23.17516, "nLon": -46.87214},
  "aPar": [
    {"sId": "CLI-102", "nLat": -23.22103, "nLon": -46.87383, "sPrec": "numero", "sEnd": "..."},
    {"sId": "CLI-205", "sCep": "13203000", "sNum": "221"}
  ],
  "iParLink": 4
}

{
  "lOk": true, "iQtd": 2, "iAchou": 2,
  "sCusto": "rua", "nKm": 9.4, "nMin": 21.0,
  "aOrdem": [0, 1],
  "sMapa": "https://www.google.com/maps/dir/?api=1&travelmode=driving&dir_action=navigate&...",
  "aMapa": ["..."],
  "aPar": [
    {"iSeq": 0, "sId": "CLI-102", "lOk": true, "iOrdem": 1, ...},
    {"iSeq": 1, "sId": "CLI-205", "lOk": true, "iOrdem": 2, ...}
  ]
}

{
  "lOk": true, "sPrec": "cep", "lAmbig": true,
  "aOpc": [
    {"sLogr": "RUA DAS FLORES", "sLocal": "CENTRO", "nLat": -27.1, "nLon": -52.6},
    {"sLogr": "AVENIDA BRASIL", "sLocal": "CENTRO", "nLat": -27.1, "nLon": -52.6}
  ]
}

curl -s https://api.qtux.com.br/geocep/localizar \
     -H "X-Api-Key: SUA_CHAVE" \
     -H "Content-Type: application/json" \
     -d '{"lOtim": true, "lVolta": true,
          "aEnd": [{"sCep": "13216340", "sNum": "161"},
                   {"sCep": "13213073", "sNum": "177"},
                   {"sCep": "13211000", "sNum": "575"}]}'

<?php
// A chave fica no servidor (variavel de ambiente ou arquivo de configuracao)
$sChave = getenv('GEOLOC_CHAVE');
$aCorpo = [
   'lOtim'  => true,
   'lVolta' => true,
   'aEnd'   => [
      ['sCep' => '13216340', 'sNum' => '161'],
      ['sCep' => '13213073', 'sNum' => '177'],
      ['sCep' => '13211000', 'sNum' => '575'],
   ],
];
$hCurl = curl_init('https://api.qtux.com.br/geocep/localizar');
curl_setopt_array($hCurl, [
   CURLOPT_POST           => true,
   CURLOPT_POSTFIELDS     => json_encode($aCorpo),
   CURLOPT_HTTPHEADER     => ['Content-Type: application/json', 'X-Api-Key: ' . $sChave],
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_TIMEOUT        => 60,
]);
$aResp = json_decode((string)curl_exec($hCurl), true);
foreach ($aResp['aRet'] ?? [] as $aEnd) {
   echo $aEnd['iOrdem'] ?? '-', ' ', $aEnd['sEnd'] ?? $aEnd['sErro'], "\n";
}
echo $aResp['aMapa'][0] ?? '', "\n";

// No servidor (Node 18+): a chave nunca vai para o navegador
const oResp = await fetch('https://api.qtux.com.br/geocep/localizar', {
   method: 'POST',
   headers: { 'Content-Type': 'application/json', 'X-Api-Key': process.env.GEOLOC_CHAVE },
   body: JSON.stringify({
      lOtim: true, lVolta: true,
      aEnd: [
         { sCep: '13216340', sNum: '161' },
         { sCep: '13213073', sNum: '177' },
         { sCep: '13211000', sNum: '575' }
      ]
   })
});
const oJson = await oResp.json();
oJson.aRet.forEach(o => console.log(o.iOrdem, o.sEnd, o.nLat, o.nLon));
console.log(oJson.aMapa[0]);

import os, requests

oResp = requests.post(
    'https://api.qtux.com.br/geocep/localizar',
    headers={'X-Api-Key': os.environ['GEOLOC_CHAVE']},
    json={'lOtim': True, 'lVolta': True,
          'aEnd': [{'sCep': '13216340', 'sNum': '161'},
                   {'sCep': '13213073', 'sNum': '177'},
                   {'sCep': '13211000', 'sNum': '575'}]},
    timeout=60)
oJson = oResp.json()
for oEnd in oJson['aRet']:
    print(oEnd.get('iOrdem'), oEnd.get('sEnd') or oEnd.get('sErro'))
print(oJson['aMapa'][0])