daAaB Cerca un percorso Trova biglietti Come funziona Diventa Partner Vai all'app
Contatti Partner Cookies Privacy Termini e Condizioni

PORTALE DEVELOPER daAaB API

Benvenuti nel portale sviluppatori di daAaB!
Di seguito tutte le chiamate a cui il vostro web service dovrà rispondere per poter integrare daAaB.

daAaB richiede le informazioni per poter collegare le soluzioni di viaggio all'agenzia e per poterla inserire tra i suoi partner di vendita.

daAaB richiede una lista di tutte le fermate (stops) dell'agenzia.
È obbligatorio fornire nome, codice, latitudine e longitudine. Le informazioni aggiuntive migliorano l'esperienza degli utenti.

PARAMETRI

Nessun parametro

RISPOSTA

Codice Modello Esempio
200
[
{
stop_id*
string

stop_lat*
number

stop_lon*
number

stop_name*
string

stop_code
string

stop_descr
string

stop_url
string (url)

location_type
integer

parent_station
string

wheelchair_boarding
string

}
]
[
{
"stop_id": "ple_roma_01",
"stop_lat": 46.0345,
"stop_lon": 24.0345,
"stop_name": "Piazzale Roma, corsia A",
"stop_code": "ple_roma_01",
"stop_descr": "La fermata di Zitelle è situata nell'isola...",
"stop_url": "https://www.azienda.it/stop/ple_roma_01",
"location_type": 1,
"parent_station": "ple_roma_01",
"wheelchair_boarding": 0
}
]
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

daAaB richiede una lista dei biglietti a scaffale che possono essere venduti.
I biglietti a scaffale sono biglietti con origine e destinazione predefinita o con un prezzo fisso (ad esempio biglietti chilometrici). Per ogni biglietto è necessario fornire codice, prezzo, nome, descrizione e durata in minuti (tutte le altre informazioni possono essere aggiunte successivamente).

PARAMETRI

Nessun parametro

RISPOSTA

Codice Modello Esempio
200
[
{
code*
string

price*
integer

currency_type
string

fare_type
string

name*
string

descr*
string

expire_minutes*
integer

}
]
[
{
"code": "ple_roma_01",
"price": 100,
"currency_type": "EUR"
"fare_type": "HOUR",
"name": "Urbano",
"descr": "Biglietto Urbano Mestre",
"expire_minutes": 90
}
]
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

Recupera il biglietto necessario per uno specifico percorso.

Richiede il biglietto necessario per il viaggio su uno specifico percorso.

PARAMETERS

Nome Modello Esempio
searchType
(body)
[ searchType
{
timestamp
string

steps*

}
]
{
"timestamp": 20180303121345,
"steps": [
{
"origin": "ple_roma_01",
"destination": "favaro"
}
]
}

RISPOSTA

Codice Modello Esempio
200
[ ticket_info
{
code*
string

price*
integer

currency_type
string

fare_type
string

name*
string

descr*
string

expire_minutes*
integer

}
]
[
{
"code": "ple_roma_01",
"price": 100,
"currency_type": "EUR",
"fare_type": "HOUR",
"name": "Urbano",
"descr": "Biglietto Urbano Mestre",
"expire_minutes": 90
}
]
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

Tutte le informazioni riguardanti il titolo di viaggo (acquisto, attivazioni, altre info).

daAaB richiede l'emissione di un biglietto.

PARAMETRI

Nome Modello Esempio
ticketInfo
(body)
ticketRequest {
ticket*

steps

timestamp
string

}
{
"ticket": {
"code": "ple_roma_01",
"price": 100,
"start_at": "20180303121345",
"expire_at": "20180303121345",
"currency_type": "EUR",
"fare_type": "HOUR",
"name": "Urbano",
"descr": "Biglietto Urbano Mestre",
"expire_minutes": 90
}
"steps": [
"origin": "ple_roma_01",
"destination": "favaro"
}
"timestamp": 20180303121345
}

RISPOSTA

Codice Modello Esempio
200
[ ticket
{
id*
string

code*
string

start_at
string

expire_at
string

qr_code
string

ticket
ticket_info {

code*
string

price*
integer

currency_type
string

fare_type
string

name*
string

descr*
string

expire_minutes*
integer

}
}
]
[
{
"id": "atvo_123456",
"code": "urbano_01",
"start_at": "20180303121345",
"expire_at": "20180303121345",
"qr_code": "20180303121345_atvo_123",
"ticket": {
"code": "ple_roma_01",
"price": 100,
"currency_type": "EUR",
"fare_type": "HOUR",
"name": "Urbano",
"descr": "Biglietto Urbano Mestre",
"expire_minutes": 90
}
}
]
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

daAaB conferma un biglietto precedentemente acquistato.

PARAMETRI

Nome Descrizione
id*
string
(path)
Your Ticket ID (Web Service ID)

RISPOSTA

Codice Modello Esempio
200
boolean
true
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

daAaB attiva un biglietto precedentemente acquistato.

PARAMETRI

Nome Descrizione
id*
string
(path)
Your Ticket ID (Web Service ID)

RISPOSTA

Codice Modello Esempio
200
boolean
true
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

daAaB fornisce tutte le informazioni riguardo un biglietto precedentemente acquistato.

PARAMETRI

Nome Descrizione
id*
string
(path)
Your Ticket ID (Web Service ID)

RISPOSTA

Codice Modello Esempio
200
[ ticket
{
id*
string

code*
string

start_at
string

expire_at
string

qr_code
string

ticket

}
]
[
{
"id": "atvo_123456",
"code": "urbano_01",
"start_at": "20180303121345",
"expire_at": "20180303121345",
"qr_code": "20180303121345_atvo_123",
"ticket": {
"code": "ple_roma_01",
"price": 100,
"currency_type": "EUR",
"fare_type": "HOUR",
"name": "Urbano",
"descr": "Biglietto Urbano Mestre",
"expire_minutes": 90
}
}
]
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}

daAaB richiede le informazioni per poter generare il codice QR del biglietto. Questo può essere generato staticamente, attraverso una stringa da voi fornita contenente tutti i dati, oppure dinamicamente seguendo le direttive che ci fornirete.

PARAMETRI

Nome Descrizione
id*
string
(path)
Your Ticket ID (Web Service ID)

RISPOSTA

Codice Modello Esempio
200
[ ticket
{
id*
string

qr_code*
string

}
]
[
{
"id": "atvo_123456",
"qr_code": "20180303121345_atvo_123",
}
]
400
{
code*
integer

message*
string

}
{
"code": 4xx,
"message": "bad input parameters"
}
500
{
code*
integer

message*
string

}
{
"code": 5xx,
"message": "generic server error"
}