Unsolved Has anyone setup an API for an internal application
-
@JaredBusch said in Has anyone setup an API for an internal application:
@scottalanmiller said in Has anyone setup an API for an internal application:
What about a RESTful API? Simple for everyone involved, typically.
A RESTful API is what I was thinking about, but I wasn't restricting the question to a RESTful API as I don't know enough about the entire process from a development point of view.
It all depends on the language. OpenAPI/REST or just a simple webhook would probably be easiest. You could do gRPC or GraphQL but I think those might be overkill for this if it's temporary.
Swagger editor can give you a structure for different languages. https://editor.swagger.io/. OpenAPI is pretty much the standard now.
You can generate server and client code.
-
So you just want the system to send a text string to a few people? Like through email?
-
Maybe this will help you -- https://www.postman.com/webinars/api-builder-registration/
-
@Danp said in Has anyone setup an API for an internal application:
Maybe this will help you -- https://www.postman.com/webinars/api-builder-registration/
I saw that name in my google search. Have not reviewed any solutions yet as I wanted to hear what people had to say. Hopefully narrowing down my scope.
-
@stacksofplates said in Has anyone setup an API for an internal application:
So you just want the system to send a text string to a few people? Like through email?
It is invoice data and EFT draft notices
sample from an invoice
-
@stacksofplates said in Has anyone setup an API for an internal application:
So you just want the system to send a text string to a few people? Like through email?
There's really nothing stopping you from doing EDI over email if the cost of the VAN is the issue, and both ERPs easily do VANs.
Just quick googling for cheap solutions you could use https://www.emailparser.com/ for the incoming side, either sort by sender or subject (or both) and save to a folder location for the incoming EDI
for Outgoing I haven't found one yet, but I'm sure there's an easy way to take your outgoing EDI folder and have it email out when a new file is placed there.
Not the best but if both sides are setup for EDI may be the quickest.
If they already have an ERP selected to replace it, I think it would be wise to see what they do and support and try to do something the new ERP can take as well so you aren't switching it again soon.
-
@JaredBusch said in Has anyone setup an API for an internal application:
@stacksofplates said in Has anyone setup an API for an internal application:
So you just want the system to send a text string to a few people? Like through email?
It is invoice data and EFT draft notices
sample from an invoice
Just so I fully understand. They copy that whole CSV or each line would be a separate message to the API?
-
@JaredBusch said in Has anyone setup an API for an internal application:
@Danp said in Has anyone setup an API for an internal application:
Maybe this will help you -- https://www.postman.com/webinars/api-builder-registration/
I saw that name in my google search. Have not reviewed any solutions yet as I wanted to hear what people had to say. Hopefully narrowing down my scope.
Postman isn't bad. I use Insomnia but there's a few different REST tools like that.
Oh nm, I see that's the builder for Postman. Yeah I usually just use swagger editor if I want to write a spec. Or just write the API if I don't need that.
-
@stacksofplates said in Has anyone setup an API for an internal application:
@JaredBusch said in Has anyone setup an API for an internal application:
@stacksofplates said in Has anyone setup an API for an internal application:
So you just want the system to send a text string to a few people? Like through email?
It is invoice data and EFT draft notices
sample from an invoice
Just so I fully understand. They copy that whole CSV or each line would be a separate message to the API?
Preferably, I would like the entire contents of the file to be the API response.
That file structure is the "normal" structure specified by the current solution. We just offered the clients to send the file directly instead of through the EDI provider for those that asked.
Granted the EDI provider manipulates it before sending it back out. All we offered was to send direct.
-
@JaredBusch said in Has anyone setup an API for an internal application:
@stacksofplates said in Has anyone setup an API for an internal application:
@JaredBusch said in Has anyone setup an API for an internal application:
@stacksofplates said in Has anyone setup an API for an internal application:
So you just want the system to send a text string to a few people? Like through email?
It is invoice data and EFT draft notices
sample from an invoice
Just so I fully understand. They copy that whole CSV or each line would be a separate message to the API?
Preferably, I would like the entire contents of the file to be the API response.
That file structure is the "normal" structure specified by the current solution. We just offered the clients to send the file directly instead of through the EDI provider for those that asked.
Granted the EDI provider manipulates it before sending it back out. All we offered was to send direct.
Ah ok.
-
Honestly I'm not sure what you're going to get doing it that way over just normal SFTP. It would be essentially the same thing just over HTTPS instead. The advantage would come in if the remote ends had a way to consume what you were sending instead of just getting it as a file. I can't speak to EDI because I have no experience with that.
-
@JaredBusch so currently the file is pushed to a server placed at customers' sites?!
You can write some http API but still you need to set the server.
Can't you othetwise keep the sftp server at the source and let customer use any ftp client (even the browser) to download it? Basically this reverse the process snd customers pull the file. -
@matteo-nunziati said in Has anyone setup an API for an internal application:
@JaredBusch so currently the file is pushed to a server placed at customers' sites?!
You can write some http API but still you need to set the server.
Can't you othetwise keep the sftp server at the source and let customer use any ftp client (even the browser) to download it? Basically this reverse the process snd customers pull the file.Winscp offers scripting automation as well so you could send that to them to automate the download to whatever folder. I believe it offers some recording function as well if you don't want to manually script it.
-
@matteo-nunziati said in Has anyone setup an API for an internal application:
@JaredBusch so currently the file is pushed to a server placed at customers' sites?!
You can write some http API but still you need to set the server.
Can't you othetwise keep the sftp server at the source and let customer use any ftp client (even the browser) to download it? Basically this reverse the process snd customers pull the file.I believe that Google removed FTP from the browser.
https://www.coywolf.news/productivity/chrome-removing-ftp/ -
@thecreaitvone91 said in Has anyone setup an API for an internal application:
@matteo-nunziati said in Has anyone setup an API for an internal application:
@JaredBusch so currently the file is pushed to a server placed at customers' sites?!
You can write some http API but still you need to set the server.
Can't you othetwise keep the sftp server at the source and let customer use any ftp client (even the browser) to download it? Basically this reverse the process snd customers pull the file.Winscp offers scripting automation as well so you could send that to them to automate the download to whatever folder. I believe it offers some recording function as well if you don't want to manually script it.
SCP is part of Windows now by default. If your OS is up to date, or if you add it directly as a component, you don't need any third party tools. SSH/SFTP/SCP is there for CMD/PS to use and you can automate that way.
-
@scottalanmiller said in Has anyone setup an API for an internal application:
@thecreaitvone91 said in Has anyone setup an API for an internal application:
@matteo-nunziati said in Has anyone setup an API for an internal application:
@JaredBusch so currently the file is pushed to a server placed at customers' sites?!
You can write some http API but still you need to set the server.
Can't you othetwise keep the sftp server at the source and let customer use any ftp client (even the browser) to download it? Basically this reverse the process snd customers pull the file.Winscp offers scripting automation as well so you could send that to them to automate the download to whatever folder. I believe it offers some recording function as well if you don't want to manually script it.
SCP is part of Windows now by default. If your OS is up to date, or if you add it directly as a component, you don't need any third party tools. SSH/SFTP/SCP is there for CMD/PS to use and you can automate that way.
My point was the other side could generate what they needed to do in the GUI of WinSCP rather than having to script it if they didn't know how https://winscp.net/eng/docs/ui_generateurl#script
-
@stacksofplates said in Has anyone setup an API for an internal application:
Honestly I'm not sure what you're going to get doing it that way over just normal SFTP. It would be essentially the same thing just over HTTPS instead. The advantage would come in if the remote ends had a way to consume what you were sending instead of just getting it as a file. I can't speak to EDI because I have no experience with that.
Because I do not have an FTP server. The software sends to other people's FTP servers.
But now the customer's customer does not have anything either and they want to pull the data from us.
To me, in the modern world, this means an API to connect and pull their data.
-
A question so I can have a better understanding of how the data should be returned. Why the repeating codes in the first line? It looks like that matches up lines, but if it's a CSV I'm not sure why each line has a description for the second column but on another line it's like FD. I'm just trying to understand the structure.
-
@stacksofplates said in Has anyone setup an API for an internal application:
A question so I can have a better understanding of how the data should be returned. Why the repeating codes in the first line? It looks like that matches up lines, but if it's a CSV I'm not sure why each line has a description for the second column but on another line it's like FD. I'm just trying to understand the structure.
Are you asking about the first two characters?
IC = Invoice something i don't recall.
IH = Invoice header
IP = Invoice Product
IQ = Invoice Product Message
IX = Invoice Tax
IM = Invoice MessageNot pictured are likely a couple more.
but everyone in the industry knows this format.
My thought was just to dump the text out in a json encoded response or something.
-
@JaredBusch said in Has anyone setup an API for an internal application:
@stacksofplates said in Has anyone setup an API for an internal application:
A question so I can have a better understanding of how the data should be returned. Why the repeating codes in the first line? It looks like that matches up lines, but if it's a CSV I'm not sure why each line has a description for the second column but on another line it's like FD. I'm just trying to understand the structure.
Are you asking about the first two characters?
IC = Invoice something i don't recall.
IH = Invoice header
IP = Invoice Product
IQ = Invoice Product Message
IX = Invoice Tax
IM = Invoice MessageNot pictured are likely a couple more.
but everyone in the industry knows this format.
My thought was just to dump the text out in a json encoded response or something.
Yeah you could return that in the JSON body. Are you planning on doing multiple login accounts or just an endpoint per client with a single key?
