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 | المعرّف النصي في عنوان 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 | المعرّف النصي للعمل. |
| 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" }
}