- Documentación
- SDK PHP · Versión 0.1
- Destinos
Destinos
En esta página
El parámetro to: de publications()->create() dice dónde publicar: nombres de red, identificadores de destino, o ambos. El SDK los resuelve dentro de la marca antes de enviar nada, y rechaza un destino que no lleva a ninguna parte.
Nombres de red e identificadores
use QuietSocial\Sdk\Network;
$client->publications()->create($post, to: [
'facebook', // todos los destinos de Facebook de la marca que pueden publicar
Network::LinkedIn, // lo mismo, con la enumeración
'dst_01k4b8x2q9r7f3m5t6v8w0y2z4', // este destino, si puede publicar
]);
- Un nombre de red (
facebook,instagram,linkedin,threads,pinterest, o un caso deNetwork) apunta a todos los destinos de esa red en la marca que pueden publicar. Las mayúsculas no importan; un nombre desconocido lanzaInvalidPost. - Un identificador de destino (
dst_…) apunta solo a ese destino, siempre que pertenezca a la marca y pueda publicar. - El orden de los destinos no importa: los mismos destinos en otro orden dan la misma publicación, y la misma clave de idempotencia.
Un destino por su nombre
Cuando una red tiene varios destinos en la marca, varios tableros de Pinterest por ejemplo, destination() restringe el nombre de red al que lleva ese nombre:
use QuietSocial\Sdk\Network;
use QuietSocial\Sdk\NetworkPost;
$post = $post->for(Network::Pinterest, fn (NetworkPost $pin) => $pin->destination('Recetas'));
$client->publications()->create($post, to: ['pinterest']);
El nombre se compara sin tener en cuenta las mayúsculas (letras acentuadas incluidas) ni los espacios de alrededor. No se envía en la petición: solo sirve para elegir el destino.
Cuando un destino no lleva a ninguna parte
Los destinos de la marca se leen una sola vez, todas las páginas, antes de enviar ninguna imagen y de crear nada. El SDK lanza entonces ValidationFailed, sin enviar nada a POST /publications:
| Código | Causa |
|---|---|
destination_unavailable |
Ningún destino de esa red puede publicar en la marca, ninguno lleva el nombre pedido, o el identificador dst_… no existe en la marca o no puede publicar. |
destination_ambiguous |
Varios destinos de la red llevan el nombre pedido: apunta a uno de ellos por su identificador. |
El estado de estas excepciones vale 0, ya que la API no respondió nada, y errors lleva el mensaje bajo la clave to. Un destino que ya no puede publicar (una conexión que restablecer, un destino desactivado) se arregla en el panel.
to: ['x'] también lanza destination_unavailable: Network::X se puede declarar en un post, pero la API todavía no publica nada en X.
Leer los destinos
Para ver dónde puede publicar una marca, y qué acepta cada destino:
foreach ($client->destinations()->all() as $destination) {
$destination->id; // dst_…
$destination->network; // pinterest
$destination->name; // Recetas
$destination->canPublish;
$destination->capabilities->maximumTextLength;
$destination->capabilities->requiresMedia;
}
destinations()->all() lee todas las páginas; destinations()->list() lee una (page, perPage hasta 100) y devuelve una Page; destinations()->find() lee un destino. Las capacidades se describen en Marcas y destinos.
Las marcas
Los destinos se resuelven siempre dentro de una marca: la de la clave o, para una clave que cubre todo el espacio, la del post (brand()) o la del cliente (argumento brand). Sin marca, una clave de espacio lee los destinos de todas sus marcas y la API rechaza la publicación. brands()->list() devuelve las marcas que ve la clave.