Lanjut ke konten

Penyedia oEmbed WordPress.com

Teks ini diterjemahkan menggunakan AI. Jika Anda ingin melihat teks asli dalam bahasa Inggris, klik di sini.

Setiap pos, halaman, lampiran, dan video VideoPress yang dihosting di WordPress.com mendukung format oEmbed melalui oEmbed API publik kami.

Apa itu format oEmbed?

Format oEmbed memungkinkan penyematan representasi URL di situs pihak ketiga. WordPress.com oEmbed API memungkinkan situs web apa pun menampilkan konten sematan (seperti foto atau video) dari WordPress.com saat pengguna memposting tautan ke sumber daya tersebut, tanpa harus mengurai sumber daya secara langsung.

Endpoint oEmbed

Endpoint WordPress.com oEmbed API tersedia di: https://public-api.wordpress.com/oembed/

Parameter query string

WordPress.com oEmbed API mendukung parameter query string berikut:

  • for (wajib): domain peminta atau domain atau nama perusahaan
  • url (wajib): URL sumber daya yang diminta. Dapat berupa URL apa pun yang dihosting di WordPress.com, termasuk domain dan subdomain wordpress.com, wp.me, videopress.com, atau domain tingkat atas apa pun yang dihosting dengan WordPress.com, misalnya TechCrunch, CNN Press Room, dll.
  • format: json atau xml, default-nya json.
  • callback: saat digunakan dengan json, fungsi callback JavaScript yang ingin Anda bungkus di sekitar output.
  • maxwidth: lebar maksimum untuk gambar/thumbnail, default-nya 440px
  • maxheight: tinggi maksimum untuk gambar/thumbnail, default-nya 330px.
  • img_size: alternatif untuk mengatur maxwidth dan/atau maxheight, teruskan sebagai [width]x[height], default-nya 440x330px.
  • as_article: true atau false, memicu ekstensi artikel non-standar untuk pos/halaman.

Parameter as_article memicu output oEmbed non-standar berupa type: article. Saat konten disajikan sebagai as_article, konten artikel dapat ditemukan di properti body, bukan di properti standar html. Properti non-standar lainnya, seperti related_topics, juga tersedia.

Fitur

  • dalam mode as_article, tag pada konten dihapus dan konten dibatasi menjadi kutipan sekitar 256 karakter.
  • dalam mode standar (yaitu as_article=false), konten disajikan sebagai markup secara lengkap, atau sebagai kutipan jika tersedia dan sebagaimana diatur oleh penulis.
  • mendukung pos dan halaman sebagai link/html atau article/body (lihat argumen as_article).
  • mendukung lampiran (gambar/media/dokumen) sebagai type link atau type photo untuk gambar (gif, jpg, jpeg, png).
  • thumbnail untuk pos dan halaman digunakan sebagai thumbnail_url jika tersedia; jika tidak, gambar pertama dalam konten akan ditampilkan.
  • gambar lokal dan jarak jauh diubah ukurannya dan/atau dipotong ulang ke dimensi yang diinginkan agar konsisten, lalu di-cache (termasuk CDN) agar lebih cepat.
  • mendukung data geolokasi, jika disediakan oleh penulis, melalui properti kustom (geo_latitude, geo_longitude)
  • mendukung related_topics dalam mode as_article (as_article=true).

Contoh respons

Permintaan Dasar, hanya parameter wajib yang diteruskan:

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/blog/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/

Respons:

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "html": "<blockquote class="wp-embedded-content" data-secret="g3Lu0xsMqa"><a href="https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/">WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland</a></blockquote>https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/embed/#?secret=g3Lu0xsMqa<script type="text/javascript">n/* <![CDATA[ */n/*! This file is auto-generated */n!function(d,l){"use strict";l.querySelector&&d.addEventListener&&"undefined"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!/[^a-zA-Z0-9]/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret="'+t.secret+'"]'),o=l.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),c=new RegExp("^https?:$","i"),i=0;i<o.length;i++)o[i].style.display="none";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute("style"),"height"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):"link"===t.message&&(r=new URL(s.getAttribute("src")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener("message",d.wp.receiveEmbedMessage,!1),l.addEventListener("DOMContentLoaded",function(){for(var e,t,s=l.querySelectorAll("iframe.wp-embedded-content"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute("data-secret"))||(t=Math.random().toString(36).substring(2,12),e.src+="#?secret="+t,e.setAttribute("data-secret",t)),e.contentWindow.postMessage({message:"ready",secret:t},"*")},!1)))}(window,document);n/* ]]> */n</script>n",
  "type": "rich",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

Mode as_article (as_article=true):

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/blog/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/&as_article=true

Respons:

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "type": "article",
  "body": "Couldn't make it to WordCamp Europe 2025? Don’t worry. While nothing beats the experience of actually being there, this post will give you a detailed summary of some of the most important and meaningful presentations held at the conference.",
  "related_topics": "News",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

Meminta ukuran gambar tertentu dan format xml

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/blog/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/&as_article=true&img_size=880x660&format=xml

Respons:

<oembed>
    <version>
        <![CDATA[ 1.0 ]]>
    </version>
    <provider_name>
        <![CDATA[ WordPress.com News ]]>
    </provider_name>
    <provider_url>
        <![CDATA[ https://en.blog.wordpress.com ]]>
    </provider_url>
    <author_name>
        <![CDATA[ Nick Schäferhoff ]]>
    </author_name>
    <author_url>
        <![CDATA[ https://en.blog.wordpress.com/author/nschaeferhoff/ ]]>
    </author_url>
    <title>
        <![CDATA[ WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland ]]>
    </title>
    <type>
        <![CDATA[ article ]]>
    </type>
    <body>
        <![CDATA[ Couldn't make it to WordCamp Europe 2025? Don’t worry. While nothing beats the experience of actually being there, this post will give you a detailed summary of some of the most important and meaningful presentations held at the conference. ]]>
    </body>
    <related_topics>
        <![CDATA[ News ]]>
    </related_topics>
    <thumbnail_url>
        <![CDATA[ https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=880%2C660 ]]>
    </thumbnail_url>
    <thumbnail_width>
        <![CDATA[ ]]>
    </thumbnail_width>
    <thumbnail_height>
        <![CDATA[ ]]>
    </thumbnail_height>
</oembed>

Tag header

WordPress.com juga menambahkan tag tautan terkait ke header situs, untuk pos, halaman, dan lampiran (hanya untuk situs publik) agar situs pihak ketiga dapat secara otomatis menemukan representasi oEmbed yang setara dengan konten Anda:

<link href="http://public-api.wordpress.com/oembed/?format=json&url=http:%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&for=wpcom-auto-discovery" rel="alternate" type="application/json+oembed" />
<link href="http://public-api.wordpress.com/oembed/?format=xml&url=http:%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&for=wpcom-auto-discovery" rel="alternate" type="application/xml+oembed" />

Terakhir diperbarui: Juni 23, 2026

Siap mulai dengan WordPress.com?

Mulai