API erişimi

2.000 şehirlik sabit veri kümesi sunan ücretsiz API ve abonelikle genişletilmiş erişim.

Ücretsiz: 60 istek/dakika ve 1.000/gün/IP. CAPIT avantajlarıyla aylık 3 €, 8 € veya 12 € abonelikler. Filtreler ve sayfalama ücretsiz küresel veri kümesini genişletmez.

API aboneliğimi seçOpenAPI belgeleri

API · https://api.capit.net

• GET /v1/cities
• GET /v1/cities/schema
• GET /v1/geography
• GET /v1/cities/export
• POST /v1/widget-token

Herkese açık erişim anahtarsızdır. Geniş erişim: üye alanında oluşturulan ve yalnızca sunucuda tutulan Bearer anahtarı. Tarayıcı: sunucunun POST /v1/widget-token ile verdiği kökene bağlı geçici belirteç (5 dakika).

q adlarda arar; country ISO kodunu kullanır; bbox alanı filtreler. Türe göre işleçler /v1/cities/schema içinde.

fields virgülle ayrılan özellikleri seçer; sort dört alan alır, azalan sıra için - kullanılır.

page 1’den başlar; pageSize varsayılan 10, en fazla 100. Abone dışa aktarımı en fazla 1.000; nextCursor -population sıralamasında page yerine kullanılır.

curl 'https://api.capit.net/v1/cities?fields=id,name,country,population&pageSize=1&lang=fr'

{
  "data": [
    {
      "id": "778910398",
      "name": "Shanghai",
      "country": "CN",
      "population": 24870895
    }
  ],
  "meta": {
    "total": 2000,
    "page": 1,
    "pageSize": 1,
    "totalPages": 2000,
    "hasMore": true,
    "version": "f1b40a9e97ac9c9af7d2ef6dea6b7b7bce529a4f42236ac881641768a76737d1",
    "tier": "public",
    "publicLimit": 2000
  }
}

400: geçersiz parametre; 401: geçersiz kimlik; 403: yetersiz hak; 429: kota doldu; 503: hizmet yok veya sorgu pahalı.

OpenAPI · Widget · HTML kodunu kopyala

<div id="capit-villes"></div>
<script src="https://api.capit.net/assets/cities/affection-cities.js?v=mobile-filters-20261107"></script>
<script>AffectionCities.create({container:'#capit-villes',lang:'tr',pageSize:10,map:true});</script>