Vai al contenuto
Blog

Prima di affidarsi a una società di integrazione API a Dubai

Redazione Tekravel
Scritto con l'aiuto dell'IA

Sulla scrivania ci sono tre preventivi. Ogni società di integrazione ha un portfolio di siti di viaggio, ognuna promette di «collegare un'API voli al vostro sito», e la più economica può partire la settimana prossima. Lei gestisce un'agenzia a Deira con sei dipendenti e un portafoglio corporate stabile, ed è stanco di ricopiare tariffe dall'extranet di un fornitore nei messaggi WhatsApp. Scegliere la società di integrazione API a Dubai che sembra più capace dà l'impressione di essere tutta la decisione.

Ne è circa un terzo. Le decisioni che stabiliscono se il sito vende non sono in nessuno dei tre preventivi, perché non sono codice. Riguardano con chi ha firmato il fornitore, a nome di chi vengono emessi i biglietti, dove stanno i soldi tra prenotazione ed emissione, e chi gestisce il rimborso quando un cliente cancella. Un integratore può collegare tutte queste cose. Non può essere nessuna di esse al posto suo.

Questo testo è scritto per il titolare che firmerà il capitolato, non per lo sviluppatore che lo leggerà.

Cosa può consegnare una società di integrazione API a Dubai, e cosa no

Una società di integrazione scrive il codice tra l'API di un fornitore e il suo sito: il modulo di ricerca, la chiamata che chiede disponibilità, il controllo del prezzo prima del pagamento, la richiesta di prenotazione, le schermate che mostrano il risultato e, se il perimetro lo prevede, le chiamate di cancellazione e rimborso. Le migliori si occupano anche delle parti noiose che contano: i nuovi tentativi quando un fornitore non risponde in tempo, i log che permettono di ricostruire una prenotazione fallita, un ambiente di test che si comporta come la produzione.

Quello che non può darle è tutto ciò che sta dall'altra parte di quel codice. Prima che venga scritta una riga, l'agenzia ha bisogno di:

  • un account presso il fornitore intestato all'agenzia stessa, con l'accesso API concesso a quell'account;
  • una capacità di emissione, con accreditamento proprio o tramite un consolidatore che emette per suo conto;
  • un accordo economico con quel fornitore: un deposito, una linea di credito o pagamenti con carta girati;
  • qualcuno che faccia il lavoro dopo l'emissione (void, rimborsi, riemissioni, cambi di orario), via API o, in mancanza, a mano.

Un integratore che si offre di «sistemare la parte fornitore» di solito le sta offrendo di prestarle la sua. Come scorciatoia per un prototipo può avere senso. Per un'azienda significa che il suo sito di prenotazione gira su un rapporto che non è suo e che non potrà portare con sé.

Il brief: sette righe per il capitolato

La maggior parte delle liti con un integratore risale a una frase che nessuno ha scritto. Metta queste nel documento che firma, con parole semplici, e chieda ogni risposta per iscritto.

  1. A nome di chi sono l'account del fornitore e le chiavi API. Dell'agenzia. Le chiavi sono credenziali: stanno nel suo gestore di password, e all'integratore si dà accesso, non la proprietà.
  2. Chi ospita il sito e chi detiene il dominio. Il dominio è registrato all'agenzia. L'account di hosting è dell'agenzia, oppure il contratto dice esattamente come viene trasferito.
  3. Quali operazioni rientrano nel perimetro. Elencatele per nome: ricerca, prezzo, prenotazione, emissione, cancellazione, rimborso, modifica. Tutto ciò che non è in elenco resta un'email all'ufficio del fornitore per tutta la vita del sito. Rimborsi e modifiche sono quelli che mancano più spesso, perché sono quelli che una demo non mostra mai.
  4. Chi lo mantiene quando il fornitore cambia API. I fornitori dismettono versioni e rinominano campi. Uno sviluppo a prezzo fisso senza clausola di manutenzione finisce il giorno in cui cambia la prima versione.
  5. Cosa significa consegna. Codice sorgente in un repository di proprietà dell'agenzia, tutte le credenziali e un documento che permetta a un altro sviluppatore di riprendere il lavoro. «Le mandiamo uno zip» non è una consegna.
  6. Come si dimostra il go-live. Una prenotazione di prova dalla ricerca al biglietto nell'ambiente di test del fornitore, cancellazione inclusa, prima che qualcuno addebiti la carta di un cliente vero.
  7. Cosa succede ai dati dei clienti. Nomi dei passeggeri, dati del passaporto e riferimenti di pagamento: dove sono conservati, chi può leggerli e come vengono cancellati.

Nessuna di queste righe richiede competenze tecniche. Ognuna costa meno concordata prima dello sviluppo che negoziata dopo.

Tre modi di portare i contenuti del fornitore sul sito

Incaricare un integratore sull'API di un fornitore è una strada. Vale la pena vederla accanto alle altre due prima che sia un preventivo a scegliere.

StradaChi detiene il rapporto col fornitoreChi mantiene il collegamentoCosa costruisce ancora l'agenziaQuanto costa andarsene
L'integratore collega il sito all'API di un fornitoreL'agenzia, se il brief lo dice; altrimenti spesso l'integratoreL'integratore con un contratto di manutenzione, o nessunoGestionale, ricarichi, anagrafica clienti, report, pagamenti, schermate di assistenzaPoco se codice e chiavi sono suoi; un rifacimento se non lo sono
L'integratore collega il sito all'API di una piattaformaLa piattaforma detiene i contratti coi fornitori; l'agenzia il suo account sulla piattaformaLa piattaforma lato fornitore; l'integratore lato suoIl sito e ciò che l'API della piattaforma non copreRiscrivere la sua parte su un'altra API
Vetrina white-label già collegataLa piattaforma, tramite l'account dell'agenziaLa piattaformaContenuti, scelte di prezzo, i propri clientiSpostare dominio e lista clienti presso un altro fornitore

La riga su cui vale la pena discutere è la prima. Dà il massimo controllo e le carica addosso il massimo: ogni cambiamento del fornitore, ogni nuovo servizio e ogni operazione lasciata fuori dalla prima versione diventa un altro progetto con un altro preventivo.

Come mettere la ricerca su un sito che già gestisce è discusso in aggiungere la ricerca voli a un sito esistente, e quale API metterci dietro in cosa sta dietro a un fornitore di API per prenotazione voli. Questo pezzo riguarda il contratto intorno al lavoro.

Dove si colloca questa piattaforma

La piattaforma dietro questo blog espone API per voli e hotel. L'accesso comincia con una conversazione e non con una chiave self-service, perché le prime domande sono quelle sopra (quali servizi, quale mercato, come si muove il denaro) e non quale endpoint chiamare. I servizi si attivano per account, e ogni account ha il proprio pannello di amministrazione con le proprie prenotazioni, clienti, ricarichi e report, quindi la colonna «costruisce ancora» della seconda riga è più corta di quanto sembri.

Se a costruire la sua parte sarà una società di integrazione, faccia quella conversazione prima di accettare un preventivo, così il perimetro descrive l'API a cui si collegherà davvero. La pagina delle travel API è da dove si parte.

Quanto costa un brief debole

Il sito va online. La ricerca funziona, i prezzi sembrano giusti e la prima prenotazione arriva un giovedì sera. Non si può emettere a nome suo, perché l'account del fornitore è dell'integratore ed emette sotto il suo accordo. La carta del cliente è già stata addebitata. Ora ha in mano una prenotazione che non può né emettere né rimborsare dal proprio sito.

Oppure funziona per un anno. Poi il fornitore passa a una nuova versione dell'API, le prenotazioni si fermano e l'integratore, il cui contratto a prezzo fisso è finito alla consegna, fa un preventivo per un nuovo progetto. Lei paga, perché gli unici che capiscono il codice sono quelli che fanno il preventivo.

Oppure l'integratore è semplicemente impegnato altrove. Un cliente deve correggere un nome su un biglietto, l'operazione di modifica non era mai nel perimetro, e due suoi dipendenti passano il pomeriggio a scrivere email all'ufficio del fornitore. Esattamente il lavoro che il sito doveva togliere di mezzo.

Ognuno di questi casi è una frase che mancava nel brief. Il codice, ogni volta, andava bene.

Redazione Tekravel

Desk tecnologie per il turismo

Il desk tecnologie per il turismo di Tekravel scrive per gli operatori: titolari di agenzie, consolidatori e gli sviluppatori che li integrano. Ogni articolo viene verificato sulla piattaforma che descrive prima della pubblicazione.