API S4C Clic - Hanes golygu

Carlmorris: /* Enghreifftiau */

2021-12-13T12:19:10Z

Enghreifftiau

← Fersiwn hŷn		Fersiwn yn ôl 12:19, 13 Rhagfyr 2021
Llinell 337:		Llinell 337:
	== Enghreifftiau ==		== Enghreifftiau ==

	* Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API.		* Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API. Dyma [https://morris.cymru/2021/12/clic-off/ fanylion am ei ddatblygiad].
	* [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf Crafwr git] arbrofol am raglenni ffeithiol a chelyddydau. Mae modd gweld y [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf/commit/5fb02c36782689c06d6ccc83158e1940463ed9a1#diff-be6b41dfef230d184a5de433928533368b74fbac3769afea00f2091470509784 data yn newid dros amser].		* [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf Crafwr git] arbrofol am raglenni ffeithiol a chelyddydau. Mae modd gweld y [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf/commit/5fb02c36782689c06d6ccc83158e1940463ed9a1#diff-be6b41dfef230d184a5de433928533368b74fbac3769afea00f2091470509784 data yn newid dros amser].

	[[Categori:API Cymraeg]]		[[Categori:API Cymraeg]]
	[[Categori:API Cymru]]		[[Categori:API Cymru]]

Carlmorris am 11:29, 8 Rhagfyr 2021

2021-12-08T11:29:22Z

← Fersiwn hŷn		Fersiwn yn ôl 11:29, 8 Rhagfyr 2021
Llinell 29:		Llinell 29:
	yn dychwelyd rhaglenni am ddyddiad.		yn dychwelyd rhaglenni am ddyddiad.

	e.e. https://www.s4c.cymru/df/listings_for_date?lang=c&date=2021-12-07		e.e. <code><nowiki>https://www.s4c.cymru/df/listings_for_date?lang=c&date=2021-12-07</nowiki></code>

	Mae llawer o ddata wrth y cais yma yn ei hun.		Mae llawer o ddata wrth y cais yma yn ei hun.
Llinell 111:		Llinell 111:

	e.e.		e.e.
	https://www.s4c.cymru/df/full_prog_details?lang=c&programme_id=537089908&show_prog_in_series=Y		<code><nowiki>https://www.s4c.cymru/df/full_prog_details?lang=c&programme_id=537089908&show_prog_in_series=Y</nowiki></code>

	Mae hyn yn cynnwys:		Mae hyn yn cynnwys:

Carlmorris: /* Enghreifftiau */

2021-12-08T11:28:15Z

Enghreifftiau

← Fersiwn hŷn		Fersiwn yn ôl 11:28, 8 Rhagfyr 2021
Llinell 338:		Llinell 338:

	* Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API.		* Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API.
	* [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf Crafwr git] arbrofol am raglenni ffeithiol a chelyddydau.		* [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf Crafwr git] arbrofol am raglenni ffeithiol a chelyddydau. Mae modd gweld y [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf/commit/5fb02c36782689c06d6ccc83158e1940463ed9a1#diff-be6b41dfef230d184a5de433928533368b74fbac3769afea00f2091470509784 data yn newid dros amser].

	[[Categori:API Cymraeg]]		[[Categori:API Cymraeg]]
	[[Categori:API Cymru]]		[[Categori:API Cymru]]

Carlmorris: /* Enghreifftiau */

2021-12-08T11:25:54Z

Enghreifftiau

← Fersiwn hŷn		Fersiwn yn ôl 11:25, 8 Rhagfyr 2021
Llinell 337:		Llinell 337:
	== Enghreifftiau ==		== Enghreifftiau ==

	Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API.		* Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API.
			* [https://github.com/carlmorris/tracio-s4c-clic-ffeithiol-celf Crafwr git] arbrofol am raglenni ffeithiol a chelyddydau.

	[[Categori:API Cymraeg]]		[[Categori:API Cymraeg]]
	[[Categori:API Cymru]]		[[Categori:API Cymru]]

Carlmorris am 11:23, 8 Rhagfyr 2021

2021-12-08T11:23:51Z

← Fersiwn hŷn		Fersiwn yn ôl 11:23, 8 Rhagfyr 2021
Llinell 14:		Llinell 14:

	Dyma restr o gategorïau (neu 'genres') a'u rhifau cod.		Dyma restr o gategorïau (neu 'genres') a'u rhifau cod.
	https://www.s4c.cymru/df/category_list_feed?lang=c
			<code><nowiki>https://www.s4c.cymru/df/category_list_feed?lang=c</nowiki></code>

	Dyw e ddim yn aml ond mae rhai categorïau fel Nadolig sydd yn mynd yn fwy neu lai pwysig.		Dyw e ddim yn aml ond mae rhai categorïau fel Nadolig sydd yn mynd yn fwy neu lai pwysig.
Llinell 23:		Llinell 24:

	Mae cyfeiriad o'r fformat:		Mae cyfeiriad o'r fformat:
	https://www.s4c.cymru/df/listings_for_date?lang=c&date=BBBB-MM-DD
			<code><nowiki>https://www.s4c.cymru/df/listings_for_date?lang=c&date=BBBB-MM-DD</nowiki></code>

	yn dychwelyd rhaglenni am ddyddiad.		yn dychwelyd rhaglenni am ddyddiad.

Llinell 34:		Llinell 37:
	Nodwch fy mod wedi torri mas llawer o raglenni isod i leihau.		Nodwch fy mod wedi torri mas llawer o raglenni isod i leihau.

			<code>
	{		{
	"listings_for_date": [		"listings_for_date": [
Llinell 92:		Llinell 96:
	]		]
	}		}
			</code>

	== Manylion am raglen unigol ==		== Manylion am raglen unigol ==

	Yn gyntaf nodwch fod modd llwytho tudalen y rhaglen mewn porwr gyda:		Yn gyntaf nodwch fod modd llwytho tudalen y rhaglen mewn porwr gyda:
	https://www.s4c.cymru/clic/programme/RHOWCH_ID_Y_RHAGLEN
			<code><nowiki>https://www.s4c.cymru/clic/programme/RHOWCH_ID_Y_RHAGLEN</nowiki></code>

	Mae hwn		Mae hwn
	https://www.s4c.cymru/df/full_prog_details?lang=c&programme_id=RHOWCH_ID_Y_RHAGLEN_YMA&show_prog_in_series=Y
			<code><nowiki>https://www.s4c.cymru/df/full_prog_details?lang=c&programme_id=RHOWCH_ID_Y_RHAGLEN_YMA&show_prog_in_series=Y</nowiki></code>

	yn dychwelyd data ar gyfer tudalen rhaglen unigol.		yn dychwelyd data ar gyfer tudalen rhaglen unigol.

Llinell 128:		Llinell 136:
	=== Allbwn - enghraifft ===		=== Allbwn - enghraifft ===

			<code>
	{		{
	"full_prog_details": [		"full_prog_details": [
Llinell 312:		Llinell 321:
	]		]
	}		}
			</code>

	== Iaith y data ==		== Iaith y data ==

	Rhowch lang=e yn lle lang=c yn y cyfeiriadau uchod i dderbyn cynnwys/disgrifiadau/ayyb yn Saesneg.		Rhowch <code>lang=e</code> yn lle <code>lang=c</code> yn y cyfeiriadau uchod i dderbyn cynnwys/disgrifiadau/ayyb yn Saesneg.

	== Heriau/problemau/nodiadau eraill ==		== Heriau/problemau/nodiadau eraill ==
Llinell 321:		Llinell 331:
	* Peidiwch â ddisgwyl ymateb gall os nad oes cynnwys ar gael neu os nad yw'r rhaglen ar gael. (Mae'r wefan ei hun yn dangos neges wall generig 'Mae'n ddrwg gennym! Roedd gwall wrth lwytho'r dudalen' yn hytrach na 'mae'r rhaglen wedi dod i ben, dyma rai eraill yn yr un gyfres...' ayyb).		* Peidiwch â ddisgwyl ymateb gall os nad oes cynnwys ar gael neu os nad yw'r rhaglen ar gael. (Mae'r wefan ei hun yn dangos neges wall generig 'Mae'n ddrwg gennym! Roedd gwall wrth lwytho'r dudalen' yn hytrach na 'mae'r rhaglen wedi dod i ben, dyma rai eraill yn yr un gyfres...' ayyb).
	* Mewn disgrifiadau mae'r symbol ¿ yn ymddangos yn lle ŵ a rhai collnodau. Mae hyn i weld y byg yn y system dw i'n meddwl?		* Mewn disgrifiadau mae'r symbol ¿ yn ymddangos yn lle ŵ a rhai collnodau. Mae hyn i weld y byg yn y system dw i'n meddwl?
	* Mae hyd y rhaglen wrth full_prog_details (duration) weithiau'n wahanol i'r maes o'r un enw wrth listings_for_date. Mae full_prog_details yn cydymffurfio gyda hyd y rhaglen ar Clic yn amlach dw i'n meddwl.		* Mae hyd y rhaglen wrth full_prog_details (duration) weithiau'n wahanol i'r maes o'r un enw wrth listings_for_date. Dolenni Cyw yn enghraifft - segues yn unig o ddarllediad 2-awr. Mae full_prog_details yn cydymffurfio gyda hyd y rhaglen ar Clic yn amlach dw i'n meddwl.
	* Nid oes ffrwd RSS/Atom o raglenni fel yr oedd yn yr hen fersiwn o'r wefan.		* Nid oes ffrwd RSS/Atom o raglenni fel yr oedd yn yr hen fersiwn o'r wefan.
	* Diolch i S4C a'r holl gynhyrchwyr am y rhaglenni, ac am ddarparu API mor ddiddorol!		* Diolch i S4C a'r holl gynhyrchwyr am y rhaglenni, ac am ddarparu API mor ddiddorol!

Carlmorris: /* Enghreifftiau */

2021-12-08T11:14:43Z

Enghreifftiau

← Fersiwn hŷn		Fersiwn yn ôl 11:14, 8 Rhagfyr 2021
Llinell 327:		Llinell 327:
	== Enghreifftiau ==		== Enghreifftiau ==

	Mae'r bot awtomatig Twitter [[https://twitter.com/offclic\|Clic Off]] yn defnyddio'r API.		Mae'r bot awtomatig Twitter [https://twitter.com/offclic Clic Off] yn defnyddio'r API.

	[[Categori:API Cymraeg]]		[[Categori:API Cymraeg]]
	[[Categori:API Cymru]]		[[Categori:API Cymru]]

Carlmorris: /* Allbwn - enghraifft */

2021-12-08T11:14:00Z

Allbwn - enghraifft

Dangos newidiadau

Carlmorris: Crëwyd tudalen newydd yn dechrau gyda 'Mae S4C Clic yn defnyddio API ac mae modd gwneud ceisiadau a derbyn data rhaglenni mewn fformat JSON. == Pwysig == Mae'r API yn llwytho yn y porwr gwe bob tro mae unrhyw un yn ymweld â Clic. Nid yw'r API yn cael ei hysbysebu o gwbl fel gwasanaeth cyhoeddus. Y ffordd fwyaf parchus i'w ddefnyddio yw i drio defnyddio fe 'fel porwr gwe'. Mewn theori mae terfyn ar y nifer o geisiadau rydych chi'n gallu gwneud o fewn amser. Does dim dogfennaeth swyd...'

2021-12-08T11:12:26Z

Crëwyd tudalen newydd yn dechrau gyda 'Mae S4C Clic yn defnyddio API ac mae modd gwneud ceisiadau a derbyn data rhaglenni mewn fformat JSON. == Pwysig == Mae'r API yn llwytho yn y porwr gwe bob tro mae unrhyw un yn ymweld â Clic. Nid yw'r API yn cael ei hysbysebu o gwbl fel gwasanaeth cyhoeddus. Y ffordd fwyaf parchus i'w ddefnyddio yw i drio defnyddio fe 'fel porwr gwe'. Mewn theori mae terfyn ar y nifer o geisiadau rydych chi'n gallu gwneud o fewn amser. Does dim dogfennaeth swyd...'

Tudalen newydd

Mae S4C Clic yn defnyddio API ac mae modd gwneud ceisiadau a derbyn data rhaglenni mewn fformat JSON.

== Pwysig ==

Mae'r API yn llwytho yn y porwr gwe bob tro mae unrhyw un yn ymweld â Clic.

Nid yw'r API yn cael ei hysbysebu o gwbl fel gwasanaeth cyhoeddus.

Y ffordd fwyaf parchus i'w ddefnyddio yw i drio defnyddio fe 'fel porwr gwe'. Mewn theori mae terfyn ar y nifer o geisiadau rydych chi'n gallu gwneud o fewn amser.

Does dim dogfennaeth swyddogol. Wrth gwrs mae'r API yn gallu newid yn y dyfodol heb rybudd.

== Categorïau ==

Dyma restr o gategorïau (neu 'genres') a'u rhifau cod.
https://www.s4c.cymru/df/category_list_feed?lang=c

Dyw e ddim yn aml ond mae rhai categorïau fel Nadolig sydd yn mynd yn fwy neu lai pwysig.

Cyw yw'r categori am yr holl raglenni plant ifanc.

== Dyddiad o raglennu ==

Mae cyfeiriad o'r fformat:
https://www.s4c.cymru/df/listings_for_date?lang=c&date=BBBB-MM-DD
yn dychwelyd rhaglenni am ddyddiad.

e.e. https://www.s4c.cymru/df/listings_for_date?lang=c&date=2021-12-07

Mae llawer o ddata wrth y cais yma yn ei hun.

=== Allbwn - enghraifft ===

Nodwch fy mod wedi torri mas rhai o'r rhaglenni isod i leihau.

{
"listings_for_date": [
{
"programme_title": "Dolenni Cyw",
"series_title": "Dolenni Cyw",
"short_billing": "Rhaglenni llawn hwyl i'r plant lleiaf.",
"duration": "02:00:00",
"thumbnail_url": "Cyw_2018.jpg",
"date_broadcast": "2021-12-07 06:00:00",
"end_dt": "2021-12-07 08:00:00",
"id": "822043194",
"episode_num": "99",
"available": "programme_id=822043194",
"container": "Y",
"contained": "N",
"b888": "N",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Nici",
"series_title": "Bing",
"short_billing": "Mae Bing yn dangos i Nici (cefnder Swla) sut i wibio¿r car clou glas i lawr y llithren. Ond mae¿n Nici¿n gwibio hefyd gan ddisgyn a thorri ei sbectol! Mae Swla¿n flin iawn a mae Bing yn ddigalon ond mae Nici yn trwsio ei sbectol!",
"duration": "00:10:00",
"thumbnail_url": "Bing_2019S4C_8.jpg",
"date_broadcast": "2021-12-07 06:00:00",
"end_dt": "2021-12-07 06:10:00",
"id": "805585815",
"episode_num": "1",
"available": "programme_id=805585815",
"container": "N",
"contained": "Y",
"b888": "N",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Halibalw",
"series_title": "Halibalw",
"short_billing": "Ymunwch â chriw Halibalw am raglen llawn hwyl, chwerthin, canu a dawnsio.",
"duration": "00:10:00",
"thumbnail_url": "Halibalw_2017.jpg",
"date_broadcast": "2021-12-07 06:10:00",
"end_dt": "2021-12-07 06:20:00",
"id": "522932118",
"episode_num": "15",
"available": "programme_id=522932118",
"container": "N",
"contained": "Y",
"b888": "Y",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Heno",
"series_title": "Heno",
"short_billing": "Heno, byddwn ni'n ymweld ag Ysgol Plascrug sydd wedi recordio cân arbennig i godi arian at elusennau lleol. Byddwn hefyd yn cael cwmni Elen Rhys, Comisiynydd Adloniant S4C, i sôn am arlwy Nadolig S4C, ac fe fydd cyfle i gymryd rhan yn ein cystadleuaeth Cracyr Dolig.",
"duration": "00:30:00",
"thumbnail_url": "Heno_2016S4C_002.jpg",
"date_broadcast": "2021-12-07 19:00:00",
"end_dt": "2021-12-07 19:30:00",
"id": "822416263",
"episode_num": "173",
"available": "programme_id=822416263",
"container": "N",
"contained": "N",
"b888": "Y",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Newyddion S4C",
"series_title": "Newyddion S4C",
"short_billing": "Newyddion S4C a'r Tywydd. ",
"duration": "00:30:00",
"thumbnail_url": "Newyddion_2020S4C_99.jpg",
"date_broadcast": "2021-12-07 19:30:00",
"end_dt": "2021-12-07 20:00:00",
"id": "821089676",
"episode_num": "179",
"available": "programme_id=821089676",
"container": "N",
"contained": "N",
"b888": "Y",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Pobol y Cwm",
"series_title": "Pobol y Cwm",
"short_billing": "Daw'r heddlu gwrth-derfysgaeth i Gwmderi i ymweld ag un o'r pentrefwyr sy'n peri gofid iddynt. Draw yn y Winllan, mae Gaynor yn agor ei chalon gyda Sion. ",
"duration": "00:25:00",
"thumbnail_url": "pobol_y_cwm_2021_12_07_P126.jpg",
"date_broadcast": "2021-12-07 20:00:00",
"end_dt": "2021-12-07 20:25:00",
"id": "820711181",
"episode_num": "126",
"available": "programme_id=820711181",
"container": "N",
"contained": "N",
"b888": "Y",
"b889": "Y",
"b_audio_described": "Y",
"b_visually_signed": "N"
},
{
"programme_title": "Rownd a Rownd",
"series_title": "Rownd a Rownd",
"short_billing": "Wrth i Barry gau ei hun i ffwrdd o¿r byd, mae trigolion y pentref yn gefn i Arthur. Mae Elen yn derbyn anrheg annisgwyl yn yr ysgol ac mae noson allan gyda Sian yn dod a hi wyneb yn wyneb gyda'r rhoddwr. Er bod Carwyn nol yn y tŷ, mae hi¿n mynd i gymryd mwy na phryd o fwyd i dawelu ei feddwl. Ac wrth i Mathew drefnu mwy o wersi meddwlgarwch, tybed os yw hi'n rhy anodd i berswadio'r gynulleidfa diweddara i roi tro arni.",
"duration": "00:30:00",
"thumbnail_url": "Rownd_a_Rownd_2021_12_07_P81_Jason.jpg",
"date_broadcast": "2021-12-07 20:25:00",
"end_dt": "2021-12-07 20:55:00",
"id": "817262575",
"episode_num": "81",
"available": "programme_id=817262575",
"container": "Y",
"contained": "N",
"b888": "Y",
"b889": "Y",
"b_audio_described": "Y",
"b_visually_signed": "N"
},
{
"programme_title": "Newyddion S4C",
"series_title": "Newyddion S4C",
"short_billing": "Newyddion S4C a'r Tywydd. ",
"duration": "00:05:00",
"thumbnail_url": "Newyddion_2020S4C_99.jpg",
"date_broadcast": "2021-12-07 20:55:00",
"end_dt": "2021-12-07 21:00:00",
"id": "821105082",
"episode_num": "179",
"available": null,
"container": "N",
"contained": "N",
"b888": "Y",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Cefn Gwlad",
"series_title": "Cefn Gwlad",
"short_billing": "Ifan Jones Evans sy'n ymweld â busnes teiars teuluol a'i bencadlys yng Ngherrigydrudion, sy'n cynnig gwasanaeth i bobl cefngwlad ar hyd a lled Gogledd Orllewin Cymru. Hefyd Ioan Doyle sy'n cwrdd a'r gwr o Edern sy'n dal tyrchod daear, Meleri Garn Fach sy'n cwrdd a bwtsiar Llanrug, a beth yw apel cefngwlad i'r gantores Lowri Evans, Trefdraeth'",
"duration": "01:00:00",
"thumbnail_url": "Cefn_Gwlad_2021-22S4C_P7_Teulu_Teiars_017.jpg",
"date_broadcast": "2021-12-07 21:00:00",
"end_dt": "2021-12-07 22:00:00",
"id": "826187255",
"episode_num": "7",
"available": "programme_id=826187255",
"container": "N",
"contained": "N",
"b888": "Y",
"b889": "Y",
"b_audio_described": "Y",
"b_visually_signed": "N"
},
{
"programme_title": "Pennod 3",
"series_title": "Rocco Schiavone",
"short_billing": "Mae Ester Baudo wedi cael ei chrogi, neu a laddodd hi ei hun' Mae ymchwiliad Rocco yn mynd i ddau gyfeiriad, gyda'r lladron neu ¿r Ester Patrizio.",
"duration": "01:00:00",
"thumbnail_url": "Rocco_Schiavone_2016S4C_P3_003.jpg",
"date_broadcast": "2021-12-07 22:00:00",
"end_dt": "2021-12-07 23:00:00",
"id": "828909032",
"episode_num": "3",
"available": "programme_id=828909032",
"container": "Y",
"contained": "N",
"b888": "Y",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Y Tywydd",
"series_title": "Y Tywydd",
"short_billing": null,
"duration": "00:02:00",
"thumbnail_url": "Y_Tywydd_2020S4C_014.jpg",
"date_broadcast": "2021-12-07 22:58:00",
"end_dt": "2021-12-07 23:00:00",
"id": "823475263",
"episode_num": "572",
"available": null,
"container": "N",
"contained": "Y",
"b888": "N",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Nyrsys",
"series_title": "Nyrsys",
"short_billing": "Cyfres yn dilyn gwaith nyrsys cymunedol Bwrdd Iechyd Hywel Dda yn y gorllewin drwy gyfnod y pandemig. Yn y bedwaredd rhaglen, fe fyddwn yn dilyn Shan, rhan o dîm y shifft nos yn Sir Gaerfyrddin wrth iddi ymweld â'r claf, Dorian Thomas, sydd wedi colli ei ddwy goes oherwydd sepsis wedi damwain ddifrifol. Bydd Joe yn trin ei ffrind, Irfon, a Melissa yn rhannu profiadau gyda'i chlaf Gill yn Aberaeron. ",
"duration": "00:35:00",
"thumbnail_url": "Nyrsys_2020S4C_02005-Edit.jpg",
"date_broadcast": "2021-12-07 23:00:00",
"end_dt": "2021-12-07 23:35:00",
"id": "810461751",
"episode_num": "4",
"available": "programme_id=810461751",
"container": "Y",
"contained": "N",
"b888": "Y",
"b889": "Y",
"b_audio_described": "N",
"b_visually_signed": "N"
},
{
"programme_title": "Y Tywydd",
"series_title": "Y Tywydd",
"short_billing": null,
"duration": "00:02:00",
"thumbnail_url": "Y_Tywydd_2020S4C_014.jpg",
"date_broadcast": "2021-12-07 23:33:00",
"end_dt": "2021-12-07 23:35:00",
"id": "823475289",
"episode_num": "573",
"available": null,
"container": "N",
"contained": "Y",
"b888": "N",
"b889": "N",
"b_audio_described": "N",
"b_visually_signed": "N"
}
]
}

== Manylion am raglen unigol ==

Yn gyntaf nodwch fod modd llwytho tudalen y rhaglen mewn porwr gyda:
https://www.s4c.cymru/clic/programme/RHOWCH_ID_Y_RHAGLEN

Mae hwn
https://www.s4c.cymru/df/full_prog_details?lang=c&programme_id=RHOWCH_ID_Y_RHAGLEN_YMA&show_prog_in_series=Y
yn dychwelyd data ar gyfer tudalen rhaglen unigol.

e.e.
https://www.s4c.cymru/df/full_prog_details?lang=c&programme_id=537089908&show_prog_in_series=Y

Mae hyn yn cynnwys:
* days_to_expire
* subtitle_e - ffeil is-deitlau Saesneg fel XML
* programme_title
* series_title (weithiau does dim gwahaniaeth rhwng programme_title a series_title)
* full_billing - disgrifiad llawn
* last_tx - dyddiad
* clic_aired - dyddiad
* id - ID unigryw y rhaglen
* unsuitable - rhywbeth i'w wneud â chynnwys
* short_billing - disgrifiad byr
* thumbnail_url - enw y JPG
* duration - mewn munudau
* series_id
* subtitle_c - ffeil is-deitlau Cymraeg fel XML
* genre_ids - un neu fwy o IDs categorïau gyda comas i'w gwahanu
* b_visually_signed
* other_version_available - ?
* audio_description - boolean
* rhaglenni yn yr un gyfres -

=== Allbwn - enghraifft ===

{
"full_prog_details": [
{
"days_to_expire": "0",
"subtitle_e": "E_A814666978.xml",
"programme_title": "Costa Rica",
"series_title": "Her Yr Hinsawdd",
"crid": "crid://s4c.co.uk/yvv-537089908",
"full_billing": "Byddwn yn dilyn yr Athro Siwan Davies i wlad drofannol Costa Rica lle mae'r bywyd gwyllt anhygoel a'r golygfeydd hudolus o dan fygythiad enfawr o ganlyniad i newid hinsawdd a degawdau o ddatgoedwigo.",
"last_tx": "9 Tachwedd 2021",
"clic_aired": "3 Tachwedd 2021",
"fav_id": "537089847",
"id": "537089908",
"mpg": "her_yr_hinsawdd__costa_rica_audio_descr_rcd89r_00308ed4e2.mp4",
"unsuitable": "0",
"short_billing": "Yr Athro Siwan Davies sy'n esbonio mwy am oblygiadau'r newid hinsawdd presennol. ",
"thumbnail_url": "Her_yr_Hinsawdd_2017_P2_Costa_Rica_1403.jpg",
"duration": "23",
"series_id": "537089862",
"subtitle_c": "C_A814666978.xml",
"vs": "0",
"imi": "imi://s4c.co.uk/yvo-n-537089908",
"genre_ids": "1",
"other_version_available": true,
"audio_description": true
}
],
"other_progs_in_genres": [
{
"count": "106",
"days_to_expire": "149",
"programme_title": null,
"series_title": "Prynhawn Da",
"short_billing": "Heddiw, mi fydd Huw yn agor ei gwpwrdd dillad ac mi fydd ein harbenigwr gwin, Dylan Rowlands, yn ymuno â ni. Bydd hefyd cyfle i gymryd rhan yn ein cystadleuaeth Cracyr Dolig.",
"thumbnail_url": "Prynhawn_Da_Cyfres_2017_Hydref.jpg",
"duration": "42",
"series_id": "520950923",
"full_billing": "Heddiw, mi fydd Huw yn agor ei gwpwrdd dillad ac mi fydd ein harbenigwr gwin, Dylan Rowlands, yn ymuno â ni. Bydd hefyd cyfle i gymryd rhan yn ein cystadleuaeth Cracyr Dolig.",
"clic_aired": "7 Rhagfyr 2021",
"fav_id": "822450302",
"id": "822454396"
},
{
"count": "9",
"days_to_expire": "78",
"programme_title": null,
"series_title": "Wil ac Aeron: Taith yr Alban",
"short_billing": "Cyfres yn dilyn y ffermwyr ifanc Wil Hendreseifion ac Aeron Pughe ar daith i'r Alban. ",
"thumbnail_url": "Wil_ac_Aeron_2016S4C_Taith_Yr_Alban_P5_163435.jpg",
"duration": "24",
"series_id": "534116591",
"full_billing": "Mae camperfan y ddau ffermwr, Wil Hendreseifion ac Aeron Pughe, wedi llwyddo i'w cludo i ben y daith o dros 1,500 o filltiroedd o amgylch yr Alban. Yn y bennod olaf maen nhw'n treulio amser yn dod i adnabod ffordd o fyw'r Crofters ar Ynys Uist yn yr Hebrides. Er bod rhai ar yr ynys yn glynu at dechnegau traddodiadol o ffermio, mae eraill yn gweld bod rhaid addasu os am oroesi. Ar ddiwedd y daith fythgofiadwy mae'r ddau yn profi uchafbwynt eu siwrnai ac yn gwireddu breuddwyd.",
"clic_aired": "12 Hydref 2021",
"fav_id": "534116664",
"id": "534116779"
},
{
"count": "2",
"days_to_expire": "26",
"programme_title": "Byw yn y Wlad",
"series_title": "Cymru ar Ffilm",
"short_billing": "Beti George sy'n rhannu rhai o'r goreuon o archif BBC Cymru - ffilmiau sy'n gofnod o ddiwedd yr hen ffordd Gymreig o fyw a geni Cymru newydd.",
"thumbnail_url": "Cymru_ar_Ffilm_2015.jpg",
"duration": "23",
"series_id": "796019604",
"full_billing": "Beti George sy'n rhannu rhai o'r goreuon o archif BBC Cymru - ffilmiau sy'n gofnod o ddiwedd yr hen ffordd Gymreig o fyw a geni Cymru newydd. Am ganrifoedd, ffermio oedd asgwrn cefn y Gymru wledig ac edrychai pobl i'w milltir sgwâr am gynhaliaeth. Ond yn gyflym iawn, diolch i'r busnes gwyliau a hamdden, cafodd rhai o'n hardaloedd prydferthaf eu gweddnewid. ",
"clic_aired": "3 Rhagfyr 2021",
"fav_id": "524301067",
"id": "524301306"
}
],
"other_progs_in_series": [
{
"days_to_expire": "9",
"subtitle_e": "E_A814676258.xml",
"programme_title": "Cymru",
"series_title": "Her Yr Hinsawdd",
"crid": "crid://s4c.co.uk/yvv-537090036",
"full_billing": "Yn y bennod olaf, bydd Siwan yn ymweld ag arbenigwyr ar draws Cymru i ddysgu mwy am yr hyn sy'n cael ei wneud i sicrhau dyfodol cynaliadwy a llewyrchus. Bydd Siwan yn ymweld â phrosiect cymunedol Ynni Padarn i ddysgu am ffyrdd o gael egni glân ar gyfer y dyfodol. Bydd Yr Athro Rhys Jones yn esbonio pam mae'n rhaid newid agwedd pobl tuag at newid hinsawdd a bydd yr Athro Gareth Wyn Jones yn trafod yr hyn y gall pobl gyffredin ei wneud i geisio lleihau lefelau carbon deuocsid yn yr atmosffer.",
"last_tx": "12 Tachwedd 2021",
"clic_aired": "12 Tachwedd 2021",
"fav_id": "537089847",
"id": "537090036",
"count": "10",
"mpg": "her_yr_hinsawdd__cymru_audio_descriptio_r39c3r_00308ef922.mp4",
"unsuitable": "0",
"short_billing": "Yr Athro Siwan Davies sy'n esbonio mwy am oblygiadau'r newid hinsawdd presennol. ",
"thumbnail_url": "Her_yr_Hinsawdd2017_P6_Cymru_002.jpg",
"duration": "23",
"series_id": "537089862",
"subtitle_c": "C_A814676258.xml",
"vs": "0",
"imi": "imi://s4c.co.uk/yvo-n-537090036"
},
{
"days_to_expire": "7",
"subtitle_e": "E_A814676486.xml",
"programme_title": "Norwy",
"series_title": "Her Yr Hinsawdd",
"crid": "crid://s4c.co.uk/yvv-537090004",
"full_billing": "Bydd yr Athro Siwan Davies yn dechrau ei thaith yn Longyearbyen, y ddinas fwyaf gogleddol yn y byd. Bydd Siwan yn cyfarfod gwyddonwyr o'r Norwegian Polar Institute a theuluoedd sydd wedi colli eu cartrefi a'u cariadon yn y cwympiadau eira dychrynllyd sy'n digwydd yn amlach y dyddiau hyn ar ynysfor Svalbard. Bydd Siwan hefyd yn teithio i ddinas Tromso yng ngogledd tir mawr Norwy i gwrdd â ffermwyr ceirw Sami sy'n gorfod newid eu ffordd draddodiadol o ffermio o ganlyniad i dywydd twym, annhymhorol",
"last_tx": "10 Tachwedd 2021",
"clic_aired": "10 Tachwedd 2021",
"fav_id": "537089847",
"id": "537090004",
"count": "10",
"mpg": "her_yr_hinsawdd__norwy_audio_descriptio_r0f96r_00308efa06.mp4",
"unsuitable": "0",
"short_billing": "Yr Athro Siwan Davies sy'n esbonio mwy am oblygiadau'r newid hinsawdd presennol. ",
"thumbnail_url": "Her_yr_Hinsawdd2017_P5_Norwy_6339.jpg",
"duration": "23",
"series_id": "537089862",
"subtitle_c": "C_A814676486.xml",
"vs": "0",
"imi": "imi://s4c.co.uk/yvo-n-537090004"
},
{
"days_to_expire": "5",
"subtitle_e": "E_A814672514.xml",
"programme_title": "California #2 ",
"series_title": "Her Yr Hinsawdd",
"crid": "crid://s4c.co.uk/yvv-537089972",
"full_billing": "Y tro hwn, mae'r Athro Siwan Davies yn parhau â'i thaith o amgylch Califfornia. Bydd yn cyfarfod teuluoedd heb dd¿r yn eu tai o ganlyniad i'r sychder, ac yn ymweld â nifer o brosiectau arloesol sydd yn ceisio ymdopi â newid hinsawdd.",
"last_tx": "23 Tachwedd 2021",
"clic_aired": "8 Tachwedd 2021",
"fav_id": "537089847",
"id": "537089972",
"count": "10",
"mpg": "her_yr_hinsawdd__california_2__audio_d_r62d0r_00308eea82.mp4",
"unsuitable": "0",
"short_billing": "Yr Athro Siwan Davies sy'n esbonio mwy am oblygiadau'r newid hinsawdd presennol. ",
"thumbnail_url": "Her_yr_Hinsawdd_P4_004.jpg",
"duration": "23",
"series_id": "537089862",
"subtitle_c": "C_A814672514.xml",
"vs": "0",
"imi": "imi://s4c.co.uk/yvo-n-537089972"
},
{
"days_to_expire": "2",
"subtitle_e": "E_A814711868.xml",
"programme_title": "California #1",
"series_title": "Her Yr Hinsawdd",
"crid": "crid://s4c.co.uk/yvv-537089940",
"full_billing": "Mae'r Athro Siwan Davies yn teithio i Galiffornia, un o daleithiau mwyaf cyfoethog yr Unol Daleithiau i ymweld â Jet Propulsion Laboratory NASA i ddysgu mwy am eu prosiectau monitro hinsawdd. Un o effeithiau mwyaf gweledol newid hinsawdd yng Nghaliffornia yw'r cynnydd enfawr yn y nifer o danau gwyllt a welwyd ar draws y dalaith. Bydd Siwan yn ymweld â dwy fenyw sydd wedi colli popeth yn y tanau yn cynnwys eu tai ac eiddo, ac yn achos Donna Fink, ei chariad.",
"last_tx": "16 Tachwedd 2021",
"clic_aired": "5 Tachwedd 2021",
"fav_id": "537089847",
"id": "537089940",
"count": "10",
"mpg": "her_yr_hinsawdd__california_1_audio_de_r2c16r_00308f843c.mp4",
"unsuitable": "0",
"short_billing": "Yr Athro Siwan Davies sy'n esbonio mwy am oblygiadau'r newid hinsawdd presennol. ",
"thumbnail_url": "Her_yr_Hinsawdd_2017_P3_California_7995.jpg",
"duration": "23",
"series_id": "537089862",
"subtitle_c": "C_A814711868.xml",
"vs": "0",
"imi": "imi://s4c.co.uk/yvo-n-537089940"
},
{
"days_to_expire": "0",
"subtitle_e": "E_A814666978.xml",
"programme_title": "Costa Rica",
"series_title": "Her Yr Hinsawdd",
"crid": "crid://s4c.co.uk/yvv-537089908",
"full_billing": "Byddwn yn dilyn yr Athro Siwan Davies i wlad drofannol Costa Rica lle mae'r bywyd gwyllt anhygoel a'r golygfeydd hudolus o dan fygythiad enfawr o ganlyniad i newid hinsawdd a degawdau o ddatgoedwigo.",
"last_tx": "9 Tachwedd 2021",
"clic_aired": "3 Tachwedd 2021",
"fav_id": "537089847",
"id": "537089908",
"count": "10",
"mpg": "her_yr_hinsawdd__costa_rica_audio_descr_rcd89r_00308ed4e2.mp4",
"unsuitable": "0",
"short_billing": "Yr Athro Siwan Davies sy'n esbonio mwy am oblygiadau'r newid hinsawdd presennol. ",
"thumbnail_url": "Her_yr_Hinsawdd_2017_P2_Costa_Rica_1403.jpg",
"duration": "23",
"series_id": "537089862",
"subtitle_c": "C_A814666978.xml",
"vs": "0",
"imi": "imi://s4c.co.uk/yvo-n-537089908"
}
]
}

== Iaith y data ==

Rhowch lang=e yn lle lang=c yn y cyfeiriadau uchod i dderbyn cynnwys/disgrifiadau/ayyb yn Saesneg.

== Heriau/problemau/nodiadau eraill ==

* Peidiwch â ddisgwyl ymateb gall os nad oes cynnwys ar gael neu os nad yw'r rhaglen ar gael. (Mae'r wefan ei hun yn dangos neges wall generig 'Mae'n ddrwg gennym! Roedd gwall wrth lwytho'r dudalen' yn hytrach na 'mae'r rhaglen wedi dod i ben, dyma rai eraill yn yr un gyfres...' ayyb).
* Mewn disgrifiadau mae'r symbol ¿ yn ymddangos yn lle ŵ a rhai collnodau. Mae hyn i weld y byg yn y system dw i'n meddwl?
* Mae hyd y rhaglen wrth full_prog_details (duration) weithiau'n wahanol i'r maes o'r un enw wrth listings_for_date. Mae full_prog_details yn cydymffurfio gyda hyd y rhaglen ar Clic yn amlach dw i'n meddwl.
* Nid oes ffrwd RSS/Atom o raglenni fel yr oedd yn yr hen fersiwn o'r wefan.
* Diolch i S4C a'r holl gynhyrchwyr am y rhaglenni, ac am ddarparu API mor ddiddorol!

== Enghreifftiau ==

Mae'r bot awtomatig Twitter [[https://twitter.com/offclic|Clic Off]] yn defnyddio'r API.

[[Categori:API Cymraeg]]
[[Categori:API Cymru]]