diff --git a/changelog.mdx b/changelog.mdx index c786ca8bf..02ee4bbe8 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -8,9 +8,16 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). + **New features** + ### Articles draft and publish endpoints - Today, we added [new endpoints](/x-api/articles/introduction) for drafting and publishing Articles via the X API. + We added two new endpoints to the X API for creating and publishing long-form [Articles](/x-api/articles/introduction): + + - `POST /2/articles/draft` — create a draft Article with a title, [DraftJS](https://draftjs.org/docs/api-reference-content-state) content state, and optional cover media uploaded through the [media endpoints](/x-api/media/introduction). + - `POST /2/articles/{article_id}/publish` — publish a draft, which returns the `post_id` of the resulting Post on X. + + Articles support rich text formatting, embedded Posts, links, and images, so you can now programmatically compose and ship long-form content end-to-end. Both endpoints use user-context auth (OAuth 1.0a or OAuth 2.0 PKCE) with the `tweet.read`, `tweet.write`, and `users.read` scopes. See the [Articles introduction](/x-api/articles/introduction) to get started. diff --git a/es/changelog.mdx b/es/changelog.mdx index 665886b55..df1c79cd9 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -6,6 +6,19 @@ keywords: ["registro de cambios", "actualizaciones de la API", "notas de la vers Para suscribirte a las actualizaciones, [**"Activa las notificaciones"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + **Nuevas funciones** + + ### Endpoints de borrador y publicación de Articles + + Agregamos dos nuevos endpoints a la X API para crear y publicar [Articles](/x-api/articles/introduction) de formato largo: + + - `POST /2/articles/draft`: crea un Article en borrador con un título, un content state de [DraftJS](https://draftjs.org/docs/api-reference-content-state) y, opcionalmente, una imagen de portada cargada a través de los [endpoints de media](/x-api/media/introduction). + - `POST /2/articles/{article_id}/publish`: publica un borrador y devuelve el `post_id` del Post resultante en X. + + Los Articles admiten formato de texto enriquecido, Posts incrustados, enlaces e imágenes, por lo que ahora puedes redactar y publicar contenido de formato largo de extremo a extremo de forma programática. Ambos endpoints usan autenticación de contexto de usuario (OAuth 1.0a o OAuth 2.0 PKCE) con los scopes `tweet.read`, `tweet.write` y `users.read`. Consulta la [introducción a Articles](/x-api/articles/introduction) para comenzar. + + ### Eventos de creación y eliminación de Posts para la X Activity API diff --git a/ja/changelog.mdx b/ja/changelog.mdx index 0b1da233d..66f2b5e13 100644 --- a/ja/changelog.mdx +++ b/ja/changelog.mdx @@ -6,6 +6,19 @@ keywords: ["変更履歴", "API 更新", "リリースノート", "新着情報" 更新情報の通知を受け取るには、[**@API**](https://x.com/api) の [**「通知をオンにする」**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) を有効にしてください。 + + **新機能** + + ### Articles の下書きおよび公開エンドポイント + + 長文の [Articles](/x-api/articles/introduction) を作成・公開するための 2 つの新しいエンドポイントを X API に追加しました。 + + - `POST /2/articles/draft`: タイトル、[DraftJS](https://draftjs.org/docs/api-reference-content-state) の content state、およびオプションで [media エンドポイント](/x-api/media/introduction) 経由でアップロードしたカバーメディアを指定して、下書きの Article を作成します。 + - `POST /2/articles/{article_id}/publish`: 下書きを公開し、生成された X 上の Post の `post_id` を返します。 + + Articles はリッチテキストの書式設定、埋め込み Post、リンク、画像をサポートしているため、長文コンテンツの作成から公開までをプログラムで一貫して実行できるようになりました。両方のエンドポイントはユーザーコンテキスト認証 (OAuth 1.0a または OAuth 2.0 PKCE) を使用し、`tweet.read`、`tweet.write`、`users.read` の各スコープが必要です。詳しくは [Articles の概要](/x-api/articles/introduction) を参照してください。 + + ### X Activity API における Post の作成・削除イベント diff --git a/ko/changelog.mdx b/ko/changelog.mdx index 2b363c81d..f9d9957d9 100644 --- a/ko/changelog.mdx +++ b/ko/changelog.mdx @@ -6,6 +6,19 @@ keywords: ["변경 로그", "API 업데이트", "릴리스 노트", "새로운 업데이트를 구독하려면 [**@API**](https://x.com/api)의 [**"알림 켜기"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive)를 활성화하세요. + + **새로운 기능** + + ### Articles 초안 및 게시 엔드포인트 + + 장문형 [Articles](/x-api/articles/introduction) 를 생성하고 게시할 수 있는 두 개의 새 엔드포인트를 X API에 추가했습니다. + + - `POST /2/articles/draft`: 제목, [DraftJS](https://draftjs.org/docs/api-reference-content-state) content state, 그리고 선택적으로 [미디어 엔드포인트](/x-api/media/introduction) 를 통해 업로드한 커버 미디어로 초안 Article을 생성합니다. + - `POST /2/articles/{article_id}/publish`: 초안을 게시하고, 그 결과로 생성된 X의 Post의 `post_id` 를 반환합니다. + + Articles는 서식 있는 텍스트, 임베디드 Post, 링크, 이미지를 지원하므로 이제 장문 콘텐츠를 처음부터 끝까지 프로그래밍 방식으로 작성하고 게시할 수 있습니다. 두 엔드포인트 모두 `tweet.read`, `tweet.write`, `users.read` 스코프와 함께 사용자 컨텍스트 인증(OAuth 1.0a 또는 OAuth 2.0 PKCE)을 사용합니다. 시작하려면 [Articles 소개](/x-api/articles/introduction) 를 참조하세요. + + ### X Activity API의 Post 생성 및 삭제 이벤트 diff --git a/pt/changelog.mdx b/pt/changelog.mdx index d31678fd7..cb1ebcb8a 100644 --- a/pt/changelog.mdx +++ b/pt/changelog.mdx @@ -6,6 +6,19 @@ keywords: ["registro de alterações", "atualizações da API", "notas de versã Para se inscrever para receber atualizações, [**"Ative as notificações"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). + + **Novos recursos** + + ### Endpoints de rascunho e publicação de Articles + + Adicionamos dois novos endpoints à X API para criar e publicar [Articles](/x-api/articles/introduction) de formato longo: + + - `POST /2/articles/draft`: cria um Article em rascunho com um título, um content state em [DraftJS](https://draftjs.org/docs/api-reference-content-state) e, opcionalmente, uma mídia de capa enviada pelos [endpoints de mídia](/x-api/media/introduction). + - `POST /2/articles/{article_id}/publish`: publica um rascunho e retorna o `post_id` do Post resultante no X. + + Os Articles oferecem suporte a formatação de texto enriquecido, Posts incorporados, links e imagens, então agora você pode redigir e publicar conteúdo de formato longo de ponta a ponta de forma programática. Ambos os endpoints usam autenticação de contexto de usuário (OAuth 1.0a ou OAuth 2.0 PKCE) com os escopos `tweet.read`, `tweet.write` e `users.read`. Consulte a [introdução aos Articles](/x-api/articles/introduction) para começar. + + ### Eventos de criação e exclusão de Posts para a X Activity API