API
فایل base.json یک فرد جزئیات و کارنامه او را در بر دارد؛ نام‌ها، زندگی‌نامه‌ها و نام‌های دیگر در فایل‌های زبان هستند.
فایل‌ها
https://api.watchittrackit.com/v1/person/{id}/base.jsonhttps://api.watchittrackit.com/v1/person/{id}/{lang}.json
هر تصویر یک شیء با مسیرهای full و thumb است.
base.json
| فیلد | نوع | توضیح |
|---|---|---|
| type | string | نوع رکورد. |
| id | number | شناسه TheTVDB. |
| slug | string | slug نشانی URL، یکتا در هر نوع. |
| popularity | number | امتیاز محبوبیت TheTVDB؛ امتیاز بالاتر یعنی محبوب‌تر. امتیازها فقط در یک نوع قابل مقایسه‌اند. |
| deleted | boolean | اگر رکورد حذف شده باشد true است. فایل‌هایش همچنان منتشر می‌مانند. |
| birthDate | string | تاریخ تولد (YYYY-MM-DD). |
| deathDate | string | تاریخ درگذشت، در صورت وجود. |
| gender | string | male، female یا other. |
| birthPlace | string | محل تولد. |
| race | string | قومیت، در صورت مشخص بودن. |
| externalLinks | { source, url }[] | پیوند به نمایه‌های فرد در جاهای دیگر: منبع و نشانی URL. |
| image | image | تصویر اصلی: پوستر برای آثار، عکس برای افراد. |
| filmography | filmography[] | اعتبارهای او در سریال‌ها و فیلم‌ها. |
| languages | string[] | زبان‌هایی که این رکورد برایشان فایل دارد. |
| remoteIds | { [site]: string } | شناسه‌ها در سایت‌های دیگر (imdb, tmdb, wikidata, …)، به تفکیک سایت. |
نمونه
{
"type": "person",
"id": 255211,
"slug": "bryan-cranston",
"popularity": 140,
"deleted": false,
"birthDate": "1953-03-07",
"gender": "male",
"birthPlace": "Hollywood, California, USA",
"image": { "full": "/images/person/255211/1705696844.jpg", "thumb": "/images/person/255211/1705696844.t.jpg" },
"filmography": [
{ "recordType": "tv", "recordId": 81189, "recordSlug": "breaking-bad", "title": "Breaking Bad",
"roleType": "Actor", "character": "Walter White", "popularityRank": 1 }
],
"languages": ["de", "en"],
"remoteIds": { "imdbperson": "nm0186505" }
}کارنامه
| فیلد | نوع | توضیح |
|---|---|---|
| recordType | string | نوع اثر (tv or movie). |
| recordId | number | شناسه اثر. |
| recordSlug | string | slug اثر. |
| title | string | نام اثر. |
| roleType | string | نوع اعتبار، مانند Actor or Director. |
| character | string | نقش ایفاشده، برای اعتبارهای بازیگری. |
| popularityRank | number | میزان محبوبیت اثر در میان اعتبارهای او (1 محبوب‌ترین است). |
فایل‌های زبان
| فیلد | نوع | توضیح |
|---|---|---|
| type | string | نوع رکورد. |
| id | number | شناسه TheTVDB. |
| lang | string | زبان این فایل. |
| name | string | نام به این زبان. |
| biography | string | زندگی‌نامه به این زبان. |
| aliases | string[] | نام‌های دیگر به این زبان. |
| filmography | { [titleId]: string } | برای هر شناسه اثر: نام اثر به این زبان. |
نمونه
{
"type": "person",
"id": 327412,
"lang": "en",
"name": "Zendaya",
"biography": "Actress, producer Zendaya Maree Stoermer Coleman…",
"aliases": ["Zendaya Maree Stoermer Coleman"],
"filmography": { "81189": "Breaking Bad" }
}