Re: API versioning

Cristian Costantini <[email protected]> Sun, 23 Feb 2014 09:25:45 +0100
Newsgroups	gmane.comp.cms.cold-fusion.devel.italian
Message-ID	<[email protected]>
--Apple-Mail-15-372401969
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=windows-1252

Ciao Luca,

non metterei mai come default l'ultima versione

https://api.dominio.ext/method/par1/par2

come fai tu, al client viene sempre fornita l'ultima versione, questo pu=F2=
 essere un problema quando il client usa esclusivamente le API deprecate. S=
e glie le togli da sotto il sedere, il client non funzioner=E0 pi=F9.
Versione Major pari si depreca, Major dispari si rimuove il deprecato.

Ripeto, =E8 un mio parere personale, forse influenzato dal tipo di servizio=
 che offro.


Cristian

Il giorno 22/feb/2014, alle ore 19.25, [email protected] ha scritto:

> Cosa intendi? non ho capito
>=20
> Luca Bianchi, PhD
>=20
> > Il giorno 22/feb/2014, alle ore 16:05, Cristian Costantini <cristian@mi=
llemultimedia.it> ha scritto:
> >=20
> > empre a mio parere non userei mai una versione major come default perch=
=E9 mi impone di modificare il client senza avere il tempo necessario per a=
ggiornare tutto creando dei disservizi ai client.
>=20


--Apple-Mail-15-372401969
Content-Type: text/html; charset=windows-1252
Content-Transfer-Encoding: quoted-printable





<head>

<style type=3D"text/css">
<!--

/* start of attachment style */
       .ygrp-photo-title{
         clear: both;
         font-size: smaller;
         height: 15px;
         overflow: hidden;
         text-align: center;
         width: 75px;
       }
       div.ygrp-photo{
         background-position: center;
         background-repeat: no-repeat;
         background-color: white;
         border: 1px solid black;
         height: 62px;
         width: 62px;
       }

       div.photo-title=20
         a,
         div.photo-title a:active,
         div.photo-title a:hover,
         div.photo-title a:visited {
           text-decoration: none;=20
       }

       div.attach-table div.attach-row {
         clear: both;
       }

       div.attach-table div.attach-row div {
         float: left;
         /* margin: 2px;*/
       }

       p {
         clear: both;
         padding: 15px 0 3px 0;
	 overflow: hidden;
       }

       div.ygrp-file {
         width: 30px;
         valign: middle;
       }
       div.attach-table div.attach-row div div a {
         text-decoration: none;
       }

       div.attach-table div.attach-row div div span {
         font-weight: normal;
       }

       div.ygrp-file-title {
         font-weight: bold;
       }
 /* end of attachment style */
        -->
        </style>
        </head>
<html><head></head><body style=3D"word-wrap: break-word; -webkit-nbsp-mode:=
 space; -webkit-line-break: after-white-space; ">


<!-- |**|begin egp html banner|**| -->

<br><br>

<!-- |**|end egp html banner|**| -->


Ciao Luca,<div><br></div><div>non metterei mai come default l'ultima versio=
ne</div><div><br></div><div><a href=3D"https://api.dominio.ext/method/par1/=
par2">https://api.dominio.ext/method/par1/par2</a></div><div><br></div><div=
>come fai tu, al client viene sempre fornita l'ultima versione, questo pu=
=F2 essere un problema quando il client usa esclusivamente le API deprecate=
. Se glie le togli da sotto il sedere, il client non funzioner=E0 pi=F9.</d=
iv><div>Versione Major pari si depreca, Major dispari si rimuove il depreca=
to.</div><div><br></div><div>Ripeto, =E8 un mio parere personale, forse inf=
luenzato dal tipo di servizio che offro.</div><div><br></div><div><br></div=
><div>Cristian<br>
<br><div><div>Il giorno 22/feb/2014, alle ore 19.25, <a href=3D"mailto:bian=
[email protected]">[email protected]</a> ha scritto:</div><br class=
=3D"Apple-interchange-newline"><blockquote type=3D"cite">












=20
<div style=3D"background-color: rgb(255, 255, 255); position: static; z-ind=
ex: auto; ">
<span style=3D"display:none">&nbsp;</span>



    <div id=3D"ygrp-text"><p>Cosa intendi? non ho capito<br>
<br>
Luca Bianchi, PhD<br>
<br>
&gt; Il giorno 22/feb/2014, alle ore 16:05, Cristian Costantini &lt;<a href=
=3D"mailto:[email protected]">[email protected]</a>&gt;=
 ha scritto:<br>
&gt; <br>
&gt; empre a mio parere non userei mai una versione major come default perc=
h=E9 mi impone di modificare il client senza avere il tempo necessario per =
aggiornare tutto creando dei disservizi ai client.<br>
</p>

    </div>
=20=20=20=20=20

=20=20=20=20

</div>



<!-- end group email -->

</blockquote></div><br></div>



<!-- |**|begin egp html banner|**| -->

<br>


<br>

<!-- |**|end egp html banner|**| -->


<div width=3D"1" style=3D"color: white; clear: both;"/>__._,_.___</div>

=20=20=20=20=20=20
=20=20=20=20=20=20
<!-- Start Recommendations -->
<!-- End Recommendations -->


<!-- |**|begin egp html banner|**| -->

<br><br>
<tt>
CFMentor<BR>
<a href=3D"http://www.cfmentor.com">http://www.cfmentor.com</a></tt>
<br><br>

<!-- |**|end egp html banner|**| -->



<!-- |**|begin egp html banner|**| -->

  <img src=3D"http://geo.yahoo.com/serv?s=3D97490485/grpId=3D170861/grpspId=
=3D559000199/msgId=3D41892/stime=3D1393143967" width=3D"1" height=3D"1"> <b=
r>

<!-- |**|end egp html banner|**| -->

=20=20=20=20
<!-- |**|begin egp html banner|**| -->

<br>



=20=20=20
=20=20=20=20=20
=20
        <!-- |**|begin egp html banner|**| -->
        <div id=3D"ygrp-vital" style=3D"background-color: #f2f2f2; font-fam=
ily: Verdana; font-size: 10px; margin-bottom: 10px; padding: 10px;">

        <span id=3D"vithd" style=3D"font-weight: bold; color: #333; text-tr=
ansform: uppercase; "><a href=3D"http://it.groups.yahoo.com/group/cfmentor;=
_ylc=3DX3oDMTJjdDE3OWVnBF9TAzk3NDkwNDg3BGdycElkAzE3MDg2MQRncnBzcElkAzU1OTAw=
MDE5OQRzZWMDdnRsBHNsawN2Z2hwBHN0aW1lAzEzOTMxNDM5Njc-" style=3D"text-decorat=
ion: none;">Visita il tuo gruppo</a></span>

     <ul style=3D"list-style-type: none; margin: 0; padding: 0; display: in=
line;">
                                                    </ul>
  </div>


<div id=3D"ft" style=3D"font-family: Arial; font-size: 11px; margin-top: 5p=
x; padding: 0 2px 0 0; clear: both;">
  <a href=3D"http://it.groups.yahoo.com/;_ylc=3DX3oDMTJicmltYmZuBF9TAzk3NDk=
wNDg1BGdycElkAzE3MDg2MQRncnBzcElkAzU1OTAwMDE5OQRzZWMDZnRyBHNsawNnZnAEc3RpbW=
UDMTM5MzE0Mzk2Nw--" style=3D"float: left;"><img src=3D"http://l.yimg.com/ru=
/static/images/yg/img/email/new_logo/yahoo_groups_it-IT_135x19.png" height=
=3D"19" width=3D"<? ol var!Pref.EmailFooterLogo.FullFeatured.Width ?>" alt=
=3D"Yahoo! Gruppi" style=3D"border: 0;"/></a>
  <div style=3D"color: #747575; float: right;"> &bull; <a href=3D"http://in=
fo.yahoo.com/privacy/it/yahoo/groups/details.html" style=3D"text-decoration=
: none;">Privacy</a> &bull; <a href=3D"mailto:cfmentor-unsubscribe@yahoogro=
ups.com?subject=3DAnnulla iscrizione" style=3D"text-decoration: none;">Annu=
lla iscrizione</a> &bull; <a href=3D"http://info.yahoo.com/legal/it/yahoo/t=
os.html" style=3D"text-decoration: none;">Condizioni generali di utilizzo d=
el servizio</a> </div>
</div>

<!-- |**|end egp html banner|**| -->

  </div> <!-- ygrp-msg -->

=20=20=20


  <br>

<!-- |**|end egp html banner|**| -->


<div style=3D"color: white; clear: both;"/>__,_._,___</div>
</body></html>
--Apple-Mail-15-372401969--