Append to Port Queue

Endpoint

http://<server>:44000/api/v2/bin

Request parameters

Parameter	Mandatory?	Data type	Description
port_id	True	Int (1-2000)	Identifies the Port.
bin_id	False	Int (1-4000000)	Identifies the Bin.
content	False	Int (0-CONTENT_MAX)	Specifies a content code.
begingroup	False	Boolean	Starts a group in the Port queue.
endgroup	False	Boolean	Ends a group in the Port queue

Request example

//Interface installation location(Ip adress)
string ip = "127.0.0.1";
//The URL to the bin interface
string url = "http://" + ip + ":44000/api/v2/bin";
//XML that will be POST'ed
string xmlData = string.Format(
@"<?xml version=""1.0""?>
<methodcall>
  <name>appendportqueue</name>
  <params>
    <port_id>4</port_id>
    <bins>
    	<bin_id>10001</bin_id>
      <begingroup>TRUE</begingroup>
      <bin_id>10002</bin_id>
      <bin_id>10003</bin_id>
      <bin_id>10004</bin_id>
      <endgroup>TRUE</endgroup>
      <bin_id>10005</bin_id>
    </bins>
  </params>
</methodcall>");
//POST to interface
HttpResponseMessage response = await new HttpClient().PostAsync(url, new StringContent(xmlData,
        Encoding.UTF8, "application/xml"));
string responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);

# Interface installation location (IP address)
ip = "127.0.0.1"
# The URL to the task interface
url = f"http://{ip}:44000/api/v2/bin"
# XML that will be POST'ed
xmlData ="""<?xml version="1.0"?>
<methodcall>
  <name>appendportqueue</name>
  <params>
    <port_id>4</port_id>
    <bins>
    	<bin_id>10001</bin_id>
      <begingroup>TRUE</begingroup>
      <bin_id>10002</bin_id>
      <bin_id>10003</bin_id>
      <bin_id>10004</bin_id>
      <endgroup>TRUE</endgroup>
      <bin_id>10005</bin_id>
    </bins>
  </params>
</methodcall>"""
# POST to interface
response = requests.post(url, data=xmlData.encode('utf-8'), headers={"Content-Type": "application/xml"})
print(response.text)

const ip = "127.0.0.1";
const url = `http://${ip}:44000/api/v2/bin`;
const xmlData = 
`<?xml version="1.0"?>
<methodcall>
  <name>appendportqueue</name>
  <params>
    <port_id>4</port_id>
    <bins>
    	<bin_id>10001</bin_id>
      <begingroup>TRUE</begingroup>
      <bin_id>10002</bin_id>
      <bin_id>10003</bin_id>
      <bin_id>10004</bin_id>
      <endgroup>TRUE</endgroup>
      <bin_id>10005</bin_id>
    </bins>
  </params>
</methodcall>`;

fetch(url, {
    method: 'POST',
    body: xmlData,
    headers: {
        'Content-Type': 'application/xml'
    }
})
    .then(response => response.text())
    .then(responseString => console.log(responseString));

<?xml version="1.0"?>
<methodcall>
  <name>appendportqueue</name>
  <params>
    <port_id>4</port_id>
    <bins>
    	<bin_id>10001</bin_id>
      <begingroup>TRUE</begingroup>
      <bin_id>10002</bin_id>
      <bin_id>10003</bin_id>
      <bin_id>10004</bin_id>
      <endgroup>TRUE</endgroup>
      <bin_id>10005</bin_id>
    </bins>
  </params>
</methodcall>

Response parameters

This method has no response parameters.

Response example

<?xml version="1.0"?>
<response>
  <params/>
</response>

OR

<?xml version="1.0"?>
<response>
  <fault>
    <code>1000</code>
  </fault>
</response>

Error Codes

Error Code	Description
1003	Mandatory parameter port_id is missing.
1004	Parameter port_id is not valid (invalid format or out of range).
1006	Parameter content is not valid (invalid format or out of range).
1010	Parameter bin_id is not valid (invalid format or out of range).
1011	The specified Bin does not exist.
1048	System is not available.
1062	Port queue is full. The maximum size of a port's port queue is 1000 bins.

Software version requirement

Software Release October 2022 and newer