دليل البدء

cURL

curl --get "$ATLAS_API_URL/v1/localities/search" \
  --header "Authorization: Bearer $ATLAS_API_KEY" \
  --data-urlencode 'q=أطار' \
  --data-urlencode 'lang=ar' \
  --data-urlencode 'limit=5'

Node.js

const url = new URL("/v1/localities/search", process.env.ATLAS_API_URL);
url.search = new URLSearchParams({
  q: "أطار",
  lang: "ar",
  limit: "5",
}).toString();

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.ATLAS_API_KEY}` },
});
const body = await response.json();
if (!response.ok) throw new Error(`ATLASMR ${response.status} ${body.code}`);
console.log(body.meta.status, body.features.length);

PHP

<?php

$url = getenv('ATLAS_API_URL') . '/v1/localities/search?' . http_build_query([
    'q' => 'أطار',
    'lang' => 'ar',
    'limit' => '5',
], '', '&', PHP_QUERY_RFC3986);

$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ATLAS_API_KEY')],
]);
$body = json_decode(curl_exec($curl), true, 512, JSON_THROW_ON_ERROR);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
    throw new RuntimeException("ATLASMR {$status} {$body['code']}");
}
echo $body['meta']['status'], ' ', count($body['features']), PHP_EOL;