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

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.
- 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à.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
| Strada | Chi detiene il rapporto col fornitore | Chi mantiene il collegamento | Cosa costruisce ancora l'agenzia | Quanto costa andarsene |
|---|---|---|---|---|
| L'integratore collega il sito all'API di un fornitore | L'agenzia, se il brief lo dice; altrimenti spesso l'integratore | L'integratore con un contratto di manutenzione, o nessuno | Gestionale, ricarichi, anagrafica clienti, report, pagamenti, schermate di assistenza | Poco se codice e chiavi sono suoi; un rifacimento se non lo sono |
| L'integratore collega il sito all'API di una piattaforma | La piattaforma detiene i contratti coi fornitori; l'agenzia il suo account sulla piattaforma | La piattaforma lato fornitore; l'integratore lato suo | Il sito e ciò che l'API della piattaforma non copre | Riscrivere la sua parte su un'altra API |
| Vetrina white-label già collegata | La piattaforma, tramite l'account dell'agenzia | La piattaforma | Contenuti, scelte di prezzo, i propri clienti | Spostare 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.