Description de l'API de programmation 1tpe.

com

L'API 1TPE vous permet de récupérer, à partir de votre propre site internet, les différentes
informations contenues dans une facture client.

Cela peut vous permettre, par exemple, d'automatiser la livraison d'un produit en utilisant
l'email du client, ou d'intégrer les informations de sa facture (nom du client, adresse, email,
montant de la facture, produit acheté etc … ) dans votre propre base de données, ou
encore de suivre précisément l'origine de vos ventes avec la variable TK et de faire des
statistiques ...

L'utilisation de l'API est extrêmement simple, seulement deux codes d'identification et le

numéro de la facture suffisent pour récupérer les données dans des variables PHP.

Cette API n'est pour le moment uniquement disponible qu'en PHP.

Utilisation de l'API de programmation 1tpe.com

Vous allez trouver dans ce pack, deux scripts PHP :

1tpe-acces-api.php

Ce premier script est à télécharger en FTP sur votre serveur, vous ne devez pas le
modifier, il sert à appeler les fonctions de l'API sur le serveur 1TPE.

exemple-code-1tpe.php

Ce second script est un exemple de code simple, vous permettant de récupérer

l'ensemble des variables de la facture de votre client. Vous pouvez intégrer cet exemple
dans vos propres scripts PHP.

Vous pouvez ensuite utiliser une ou plusieurs des variables récupérées pour les intégrer à

Plate forme d'affiliation 1tpe.com

vos propres scripts, les enregistrer dans votre base de données, les envoyer à un
autorépondeur etc …

Contenu de « exemple-code-1tpe.php »

<?
//------- vos variables personnelles à renseigner ci-dessous

$membreid="xxxxxxxx"; // --- votre Membre ID N° 1tpe en bas de la page "configuration" de votre compte
$code1tpeapi="xxxxxx"; // --- votre Code activation API 1en bas de la page "configuration" de votre compte
$facture="xxxxxxxxxxx"; // --- le numéro de la facture du client dont vous voulez les informations

//---------------- appel de votre API 1tpe ne pas modifier ------------------

include("1tpe-acces-api.php");
//---------------- fin appel de votre API 1tpe ne pas modifier--------------

//---------------- récupération des données pour votre utilisation --------------

///// vous pouvez utiliser une ou plusieurs des variables ci-dessous dans vos scripts php /////
//// dans l'exemple ci dessous on les affiche toutes simplement sur la page /////

echo $ce1tpe."<br>"; //---- Message de confirmation / REPONSES possibles :

// demande valide = VALIDE
// erreur connexion = ERREUR MEMBRE
// numéro facture invalide = ERREUR FACTURE

echo $amountc."<br>"; //---- Montant de la facture en euros

echo $datec."<br>";
echo $heurec."<br>";
echo $nomprodc."<br>";
echo $affic."<br>";
echo $vendc."<br>";
echo $trackc."<br>";
echo $nomc."<br>";
echo $adressc."<br>";
echo $codepc."<br>";
echo $villec."<br>";
echo $paysc."<br>";
echo $emailc."<br>";
echo $datac."<br>";
echo $rembc."<br>";
echo $numprodc."<br>";
echo $gainsvendc."<br>";
echo $gainsaffc."<br>";
//---- Date de la commande
//---- Heure de la commande
//---- Nom du produit commandé
//---- Affilié ayant vendu le produit
//---- Vendeur du produit
//---- Variable de tracking :TK
//---- Nom du client
//---- Adresse du client
//---- Code postal du client
//---- Ville du client
//---- Pays du client
//---- Email du client
//---- Variable info client DATA
//---- Achat remboursé / REPONSES : OUI – NON
//---- Numéro du produit dans le catalogue
//---- Gains versés au vendeur en euros
//---- Commission versée à l'affilié en euros

?>

Pour faire fonctionner ce script, il vous suffit de modifier les variables :

$membreid="xxxxxxxx"; // --- votre Membre ID N° 1tpe en bas de la page "configuration" de votre compte

$code1tpeapi="xxxxxx"; // --- votre Code activation API 1en bas de la page "configuration" de votre compte

en indiquant les numéros d'identification, disponibles en bas de la page « configuration »

de votre compte, à la place de xxxxxxxx

Le numéro $facture="xxxxxxxxxxx"; correspond au numéro de la facture dont vous désirez

récupérer les informations.

Plate forme d'affiliation 1tpe.com

Si vous désirez faire des tests avec une facture fictive, utilisez le numéro de facture
suivant : 2222266665555544 ( l'email récupérée sera alors celle de votre compte 1tpe )

VENDEURS

Vous pouvez récupérer automatiquement ce numéro dans votre page d'accès, dès que le
client ayant payé votre produit revient sur votre site.

Récupération du numéro de facture dans votre page d'accès

Pour récupérer automatiquement le numéro de facture dans votre page d'accès (en PHP),
vous devez utiliser le Tag « ccc » dans une variable de votre URL.

Comme ceci :

http://www.adresse-url-de-votre-page-dacces.com?facture=ccc

Lorsque le client accédera à votre page d'accès le système 1TPE remplacera

automatiquement les trois ccc par le numéro de facture.

Vous pouvez bien sûr remplacer le nom de la variable « facture » par le nom de votre
choix..., par exemple « numéro » :

http://www.adresse-url-de-votre-page-dacces.com?numero=ccc

Votre client arrivera donc sur votre page avec comme adresse url :

http://www.adresse-url-de-votre-page-dacces.com?facture=201020154821

201020154821 étant un numéro de facture imaginaire, pris comme exemple ici.

Voici maintenant un exemple de script qui envoi automatiquement un email au client

lorsqu'il accède à la page d'accès de votre produit.

PS : attention dans cet exemple un email est envoyé lors de chaque accès à la page, si le
client y accède plusieurs fois, il recevra plusieurs fois le même message …

Ce script est dans la page :

exemple-code-pacces.php

du pack de l'API.

Plate forme d'affiliation 1tpe.com

 Contenu de « exemple-code-pacces.php »

<?
// ------------------ récupération du numéro de facture dans votre page d'accès

if (isset($_GET['c'])){$c=$_GET['c'];}else{$c="";}

//------- vos variables personnelles à renseigner ci-dessous

$membreid="xxxxxxxx"; // --- votre Membre ID N° 1tpe en bas de la page "configuration" de votre compte
$code1tpeapi="xxxxxx"; // --- votre Code activation API 1en bas de la page "configuration" de votre compte
$facture=$c; // --- déclaration de la variable "$c" comme numéro de facture à interroger

//---------------- appel de votre API 1tpe ne pas modifier ------------------

include("1tpe-acces-api.php");
//---------------- fin appel de votre API 1tpe ne pas modifier--------------

//---------------- récupération des données pour votre utilisation --------------

////////// ==> utilisation de seulement 2 variables, l'email du client et le nom du produit

if($ce1tpe=="VALIDE") { // ---- si les données récupérées de la facture sont valides, envoyer un email au client

$message="Bonjour ".$emailc."

Merci d'avoir acheté notre produit :

".$nomprodc."

J'espère qu'il vous satisfera parfaitement.

Pour accéder à votre produit, cliquez sur

le lien ci-dessous :

http://www.xxxxx

et utilisez le mot de passe suivant : DFRT548DFG

Si vous avez des questions, contactez-nous

avec l'email : support@monsiteamoi.com

Cordialement

VOUS

PS : cet achat apparaitra sur votre relevé

de banque avec comme libellé SMCONSEILS

";

$to=$emailc;
$corps=$message;
$email1="VOTRE@EMAIL.ICI";
$sujet="SUJET DE VOTRE MESSAGE";
$headers = "From: 1tpe.com <VOTRE@EMAIL.ICI>\n";
$headers .= "Reply-To:".$email1."\n";
mail($to, $sujet, $corps, $headers);

} //----------- fin véfication facture valide

?>
<HTML>
<HEAD>

Plate forme d'affiliation 1tpe.com

</HEAD>
<BODY>

Ici le contenu de votre page d'accès

</BODY>
</HTML>

AFFILIES

Vous pouvez récupérer automatiquement, en temps réel, toutes les données des factures
des clients que vous avez référés simplement en indiquant dans votre compte 1TPE,
rubrique « configuration » l'adresse URL d'une page sur votre site, ou nous enverrons
en POST, le numéro de la facture du client.

Dès que le client accédera au produit, nous enverrons une requête POST sur votre page
qui contiendra comme variable :

fac=xxxxxxxx (xxxxx étant le numéro de la facture du client)

Vous devrez donc récupérer cette variable dans votre page pour pouvoir l'utiliser, par
exemple en php :

<?php
// ------------------ récupération du numéro de facture dans votre page

if (isset($_POST['fac'])){$fac=$_POST['fac'];}else{echo "Facture ?; exit() ;}

?>

Ensuite il vous suffira d'exploiter cette variable avec vos propres scripts ou avec l'API
1TPE pour obtenir toutes les données de la facture, voici un script d'exemple :

Ce script est dans la page :

exemple-code-pageaffilie.php

du pack de l'API.

Contenu de « exemple-code-pageaffilie.php »

<?php
// ------------------ récupération du numéro de facture dans votre page

if (isset($_POST['fac'])){$fac=$_POST['fac'];}else{echo "Facture ?"; exit() ;}

$membreid="xxxxxxxx"; // --- votre Membre ID N° 1tpe en bas de la page "configuration" de votre compte
$code1tpeapi="xxxxxx"; // --- votre Code activation API 1en bas de la page "configuration" de votre compte
$facture=$fac; // --- déclaration de la variable "$c" comme numéro de facture à interroger

//---------------- appel de votre API 1tpe ne pas modifier ------------------

include("1tpe-acces-api.php");
//---------------- fin appel de votre API 1tpe ne pas modifier--------------

Plate forme d'affiliation 1tpe.com

//---------------- récupération des données pour votre utilisation --------------

if($ce1tpe=="VALIDE") { // ---- si les données récupérées de la facture sont valides les afficher

echo "amount : ".$amountc."<BR />";

echo "date : ".$datec."<BR />";
echo "heure : ".$heurec."<BR />";
echo "nomprod : ".$nomprodc."<BR />";
echo "affi : ".$affic."<BR />";
echo "vend : ".$vendc."<BR />";
echo "track : ".$trackc."<BR />";
echo "nom : ".$nomc."<BR />";
echo "adress : ".$adressc."<BR />";
echo "codep : ".$codepc."<BR />";
echo "ville : ".$villec."<BR />";
echo "pays : ".$paysc."<BR />";
echo "email : ".$emailc."<BR />";
echo "data : ".$datac."<BR />";
echo "remb : ".$rembc."<BR />";
echo "numprod : ".$numprodc."<BR />";
echo "gainsvend : ".$gainsvendc."<BR />";
echo "gainsaff : ".$gainsaffc."<BR />";

}
?>

ATTENTION : la requête POST étant effectuée de façon asynchrone, en temps réel,

directement par nos serveurs vers votre page, vous ne pouvez pas visualiser les données
tel que décrit dans le script ci-dessus (ce n'est qu'un exemple).

Votre page sur votre site doit enregistrer ces données dans une base de données, un
fichier texte, les envoyer par email etc … pour que vous puissiez les consulter ou les
utiliser … !

Si vous désirez tester le fonctionnement de votre page sur votre site, remplacez le test de
l’existence de la variable fac en POST par un test en GET dans le script ci-dessus :

if (isset($_GET['fac'])){$fac=$_GET['fac'];}else{echo "Facture ?"; exit() ;}

Puis appelez votre page avec la variable fac :

http://votresite.com/votrepage.php?fac=xxxxxxx

En remplaçant xxxxxxx par le numéro de facture de l'un de vos clients …

Une fois le test effectué. remettez le test d’existence de la variable en POST dans le script
de votre page ...

Vous pouvez imaginer autant de scripts que nécessaire pour utiliser efficacement cette
API et automatiser vos business d'affiliation, à vos claviers … :-)

Sylvain MILON
1tpe.com

Plate forme d'affiliation 1tpe.com