Перейти к основному содержимому

Работа с породами

Список и поиск информации о породах: породы собак.

Список всех пород​

curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds

Поиск пород​

curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/breeds/search?q=terrier"
🎮 Interactive DemoOpen in new tab ↗

Фильтр по группе пород​

Используйте breed_groups или exclude_breed_groups (через запятую, без учёта регистра), чтобы включить или исключить группы. GET /v1/breeds/breed-groups возвращает доступные группы.

curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/breeds?breed_groups=Toy,Working"

Получить сведения о породе​

У пород собак числовые ID, например 1 — аффенпинчер, 115 — немецкая овчарка.

curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds/1

Пример ответа​

{
  "id": "1",
  "name": "Affenpinscher",
  "species_id": "2",
  "life_span": "12-15",
  "temperament": "Confident, alert, playful, loyal, courageous",
  "origin": "Germany",
  "country_code": "DE",
  "breed_group": "Toy",
  "reference_image_id": "BJa4kxc4X",
  "image": {
    "id": "BJa4kxc4X",
    "width": 1600,
    "height": 1199,
    "url": "https://cdn2.thedogapi.com/images/BJa4kxc4X.jpg"
  }
}

Локализация и перевод​

Для аккаунтов Startup и Enterprise данные о породах локализуются: название породы даётся на основном языке страны происхождения, а все текстовые поля переводятся.

Используйте параметр запроса lang, чтобы задать язык ответа, например en, de, es, fr или it. Работает на всех эндпоинтах /breeds:

https://api.thedogapi.com/v1/breeds?lang=de
https://api.thedogapi.com/v1/breeds/1?lang=de

Список фактов о породе​

curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/facts/breed/115?limit=5"