API.publishFromText

Esta acção permite-lhe criar uma ou várias publicações (até 50) directamente a partir de texto simples.

Pedido

api_key Utilize a sua chave API.
login Utilize o endereço de correio electrónico de um perfil de conta com acesso às API.
md5_pwd Utilize a palavra-passe do perfil, encriptada em formato MD5.
subscription_code Utilize o código API fornecido na página "As suas subscrições" ou recuperado pela API getAccountSubscriptions.
documents

Tabela com os documentos a publicar.

Cada documento em si é uma tabela que contém os seguintes elementos (a ordem é irrelevante):

Obrigatório:

  • Text: Texto simples para converter numa publicação.

Facultativo: (Os valores predefinidos estão sublinhados):

  • CategoryReference: Categoria da publicação
    • Diversos: MISC
    • Notícias: NEWS
    • Artes: ARTS
    • Automóvel: AUTO
    • Negócios: BUSINESS
    • Cinema: MOVIES
    • Cultura: CULTURE
    • Educação: SCHOOL
    • Viagens: TRAVEL
    • Humor: HUMOR
    • Jogos de vídeo: VIDEOGAMES
    • Direito: LAW
    • Literatura: LITERATURE
    • Música: MUSIC
    • Natureza: NATURE
    • Política: POLITICS
    • Religião: RELIGION
    • Saúde: HEALTH
    • Ciência: SCIENCES
    • Sexy: SEXY
    • Sociedade: PEOPLE
    • Desporto: SPORTS
    • Tecnologia: TECH

  • FormatReference: Formato da publicação
    • Diversos: MISC
    • Álbuns: ALBUMS
    • BD: BD
    • Brochuras: BROCHURES
    • Catálogos: CATALOGS
    • Revistas aos quadradinhos: COMICS
    • Jornais: NEWSPAPERS
    • Livros: BOOKS
    • Revistas: MAGAZINES
    • Mangas: MANGAS
    • Manuais: MANUALS
    • Multimédia: MULTIMEDIA
    • Partituras: SHEETMUSIC
    • Apresentações: PRESENTATIONS
    • Relatórios: REPORTS
    • Romances: NOVELS

  • DialectReference: Idioma da publicação, sob a forma de um código ISO- 639-1 de 2 letras ou DESCONHECIDO
  • Name: Título da publicação (se não for preenchido, será utilizado o nome do ficheiro)
  • Description: Descrição da publicação
  • Date: Data da publicação
  • IsPublished: Estado da activação (verdadeiro ou falso)
  • PublishingMode: Modo de acesso (público: 1, privado: 2)
  • PrivateUrlMode: Criar um URL privado (sim: 1; não: 0)
  • SubscribingMode: Autorizar o acesso aos subscritores (sim: 1; não: 0)
  • CommentingMode: Tratamento dos comentários (Nenhum: 0, moderar todos: 1, moderar excepto contactos: 2, aceitar apenas de contactos: 3, aceitar todos: 4)
  • DownloadingMode: Modo de transferência (Não: 0, apenas contactos: 1, sim: 2)
  • MiniMode: Autorizar o MiniCalaméo (sim: 1; não: 0)
  • AdultMode: Conteúdos para adultos (sim: 1; não: 0)
  • ReadingMode: Sentido da leitura (Da esquerda para a direita: 0, da direita para a esquerda: 1)
  • LicensingMode: Licença (nenhuma: deixar em branco; pd (domínio público); Creative commons: by/by_nc/by_nc_nd/by_nc_sa/by_nd/by_sa)
  • LogoUrl: Logótipo do URL personalizado
  • LogoLink: Ligação do logótipo personalizado
  • BackgroundUrl: URL do ambiente de fundo personalizado
  • MusicUrl: URL da música de fundo personalizada
  • MusicMode: Modo da música de fundo (cíclico: 0, reproduzir uma vez:1)
  • SoundEffectMode: Modos dos efeitos sonoros (sim: 1; não: 0)
  • FlipSoundUrl: URL do som de virar a página personalizado

Resposta

Este pedido devolve uma série com uma linha por documento publicado cuja chave é um contador que começa a partir de 1. Cada linha constitui uma série com as seguintes informações:

Type "Sucesso" ou "Erro".
Message Texto que confirma o sucesso ou explica o erro.
Book

Em caso de fracasso, não está presente.

Em caso de sucesso, série com os seguintes elementos:

  • Code: Chave de identificação única da publicação.
  • Name: Título da publicação.
  • Description: Descrição da publicação.
  • IsPrivate: Envia 1 se a publicação for privada e 0 em caso contrário.
  • AllowMini: Envia 1 se a publicação permitir acesso ao miniCalaméo e 0 em caso contrário.
  • Date: Data de referência da publicação.
  • Creation: Data de criação da publicação.
  • Modification: Data da última alteração à publicação.
  • PublicUrl: URL absoluto da apresentação da publicação.
  • ViewUrl: URL absoluto da página de leitura da publicação.
  • CommentsUrl: URL absoluto dos comentários à publicação.
ErrorCode Código de erro. Vazio em caso de sucesso.

Caso ocorram problemas, é devolvida uma mensagem de erro.

Exemplo





Publish documents



getError();
	 
    if ($err) {
       // Apresentar os erros
       echo 'SOAP Error: ' . $err;
       // Se ocorrer um erro, é inútil continuar
       die('Ocorreu um erro!');
    }
    $message = 'API.publishFromText';

    $doc1 = array(
					'Text'		=> 'O meu primeiro texto',
					'Name'		=> 'O meu primeiro documento',
					'Description'	=> 'Este é o primeiro documento',
					'Date'		=> '2007-12-24',
					'IsPublished'	=> true,
					'PublishingMode'=> 2,
					'AdultMode'	=> 1
				);
				
    $doc2 = array(
					'Text'		=> 'O meu segundo texto',
					'Name'		=> 'O meu segundo documento',
					'Description'	=> 'Este é o segundo documento',
					'Date'		=> '2004-12-24',
					'IsPublished'	=> false,
					'PublishingMode'=> 1
				);
				
				

    $params = array (
		    'api_key'		=> '123346544abdefbca1546854',
		    'login'		=> 'email@aminhaconta.com',
		    'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
		    'subscription_code'	=> '05511df55155d5a5bc5',
		    'documents'	        => array($doc1, $doc2)
		    );

    $result = $client->call($message, $params);

    if ($client->fault) {
        // Ocorreu um erro
        die('Ocorreu um erro!');
    } else {
        // Verificar se não foi devolvido um erro SOAP
        $err = $client->getError();
        if ($err) {
            // Apresentar o erro
	    echo 'SOAP Error: ' . $err ;
        } else {
	    // Correu tudo bem, pode processar o resultado => $result
            echo '
';
            echo 'Livros criados com sucesso!';
            echo '
';
        }
    }

?>

Customer service discussions
Loading...
Favicon Get Satisfaction support network